.. _sphx_glr_auto_examples_musiclang_api:

Integration with MusicLang API
-------------------------------

This is a simple example of how to integrate the MusicLang API into your application.
You'll need to have an MUSICLANG_API_KEY `here <www.musiclang.io>`_ and set your environment variable to use it.





.. raw:: html

    <div class="sphx-glr-thumbnails">

.. thumbnail-parent-div-open

.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="In this example : - We directly generate a drum&#x27;n&#x27;bass sample from scratch using the generate_from_scratch method of the MusicLang API - We save the predicted score to a midi file">

.. only:: html

  .. image:: /auto_examples/musiclang_api/images/thumb/sphx_glr_03_generate_from_scratch_thumb.png
    :alt:

  :ref:`sphx_glr_auto_examples_musiclang_api_03_generate_from_scratch.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Create a drum'n'bass sample</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="In this example : - We load a 4 bar template from a midi file - We add a clean guitar track - We call the musiclang API to predict the score - We save the predicted score to a midi file">

.. only:: html

  .. image:: /auto_examples/musiclang_api/images/thumb/sphx_glr_01_add_guitar_track_thumb.png
    :alt:

  :ref:`sphx_glr_auto_examples_musiclang_api_01_add_guitar_track.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Generate a new track on a midi file</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="In this example : - We load a 4 bar template from a midi file (drum and bass - We regenerate only the first and last bar of the bass (second track)">

.. only:: html

  .. image:: /auto_examples/musiclang_api/images/thumb/sphx_glr_04_regenerate_some_bars_thumb.png
    :alt:

  :ref:`sphx_glr_auto_examples_musiclang_api_04_regenerate_some_bars.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Regenerate only some bars of a specific tracks</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="In this example : - We load two parts of a same song (midi file with same tracks) - We ask musiclang to create a 4-bar transition for us between those two tracks - We get back the score with only the transition OR the full score">

.. only:: html

  .. image:: /auto_examples/musiclang_api/images/thumb/sphx_glr_08_create_transition_between_parts_thumb.png
    :alt:

  :ref:`sphx_glr_auto_examples_musiclang_api_08_create_transition_between_parts.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Create a transition between two parts of a song</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="MusicLang allows you to control the chord progression of your song. In this example :">

.. only:: html

  .. image:: /auto_examples/musiclang_api/images/thumb/sphx_glr_06_control_the_tracks_thumb.png
    :alt:

  :ref:`sphx_glr_auto_examples_musiclang_api_06_control_the_tracks.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Deep musical control over the generation</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="MusicLang allows you to control the chord progression of your song. In this example :">

.. only:: html

  .. image:: /auto_examples/musiclang_api/images/thumb/sphx_glr_05_control_chord_progression_thumb.png
    :alt:

  :ref:`sphx_glr_auto_examples_musiclang_api_05_control_chord_progression.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Control the chord progression of the generation</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="In this example : - We do the same example that 03_generate_from_scratch.py but in async mode - We poll the API until the prediction is done every 3 seconds">

.. only:: html

  .. image:: /auto_examples/musiclang_api/images/thumb/sphx_glr_03_generate_async_thumb.png
    :alt:

  :ref:`sphx_glr_auto_examples_musiclang_api_03_generate_async.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Create a song in async mode</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="In this example : - We load an existing song - We ask musiclang to continue it for 4 bars">

.. only:: html

  .. image:: /auto_examples/musiclang_api/images/thumb/sphx_glr_07_continue_song_thumb.png
    :alt:

  :ref:`sphx_glr_auto_examples_musiclang_api_07_continue_song.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Extend an existing sample or song</div>
    </div>


.. thumbnail-parent-div-close

.. raw:: html

    </div>


.. toctree::
   :hidden:

   /auto_examples/musiclang_api/03_generate_from_scratch
   /auto_examples/musiclang_api/01_add_guitar_track
   /auto_examples/musiclang_api/04_regenerate_some_bars
   /auto_examples/musiclang_api/08_create_transition_between_parts
   /auto_examples/musiclang_api/06_control_the_tracks
   /auto_examples/musiclang_api/05_control_chord_progression
   /auto_examples/musiclang_api/03_generate_async
   /auto_examples/musiclang_api/07_continue_song