> ## Documentation Index > Fetch the complete documentation index at: https://docs.breezeblue.ai/llms.txt > Use this file to discover all available pages before exploring further. # Create a track > Add an audio track for music or sound effects. Set chapter_id to limit it to one chapter. Its ID is returned in created_ids.
## Continue building Upload files and place them on tracks. Place audio on a track. Run the same operations from a terminal.
## OpenAPI ````yaml /openapi.json post /v1/studio/projects/{project_id}/tracks openapi: 3.1.0 info: title: Breeze Developer API description: >- Breeze Developer API for models, voices, text-to-speech, history, balance, usage, and browser-managed API keys. version: 1.0.0 servers: - url: https://api.breeze.blue security: [] tags: - name: Models description: Supported TTS models. - name: Text to Speech description: Text-to-speech synthesis and instruction enhancement. - name: Voices description: Saved voices and voice settings. - name: Voice Previews description: Create, audition, and save temporary voice previews. - name: Account description: Balance, usage, and API keys. - name: History description: Generated audio history. - name: Studio description: Projects, scripts, arrangement and audio materials. paths: /v1/studio/projects/{project_id}/tracks: post: tags: - Studio summary: Create a track description: >- Add an audio track for music or sound effects. Set chapter_id to limit it to one chapter. Its ID is returned in created_ids. operationId: studio_tracks_create parameters: - name: project_id in: path required: true schema: type: string title: Project Id description: Studio project ID, such as prj_…. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/TrackCreate' responses: '200': description: The updated project. content: application/json: schema: $ref: '#/components/schemas/ProjectResult' headers: x-breeze-api-key-id: description: >- Public API key identifier used to authenticate the request, when an API key was used. schema: type: string '401': description: HTTP 401 error response. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '404': description: HTTP 404 error response. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '409': description: HTTP 409 error response. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '422': description: HTTP 422 error response. content: application/json: schema: $ref: '#/components/schemas/ValidationErrorResponse' '504': description: HTTP 504 error response. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' security: - ApiKeyAuth: [] x-codeSamples: - lang: cURL label: cURL source: |- curl \ --request POST \ --url "https://api.breeze.blue/v1/studio/projects/prj_example/tracks" \ --header "xi-api-key: $BREEZE_API_KEY" \ --header "Content-Type: application/json" \ --data '{ "expected_edit_token": "replace_with_current_edit_token", "operation_id": "123e4567-e89b-42d3-a456-426614174000", "name": "Background music", "volume": 0.3 }' - lang: Python label: Python source: |- from breeze_blue import BreezeBlue client = BreezeBlue() result = client.studio.tracks.create("prj_example", { "expected_edit_token": "replace_with_current_edit_token", "operation_id": "123e4567-e89b-42d3-a456-426614174000", "name": "Background music", "volume": 0.3, }) - lang: TypeScript label: TypeScript source: |- import { BreezeBlueClient } from "@breeze.blue/sdk"; const client = new BreezeBlueClient(); const result = await client.studio.tracks.create("prj_example", { expectedEditToken: "replace_with_current_edit_token", operationId: "123e4567-e89b-42d3-a456-426614174000", name: "Background music", volume: 0.3, }); components: schemas: TrackCreate: properties: expected_edit_token: type: string maxLength: 128 minLength: 1 title: Expected Edit Token description: >- edit_token from your latest read or write of this project. A stale token returns 409. operation_id: type: string format: uuid title: Operation Id description: >- New UUID for each write. Retrying with the same ID and body returns the original result instead of repeating the write. name: type: string maxLength: 200 minLength: 1 title: Name description: Track name. chapter_id: anyOf: - type: string format: uuid - type: 'null' title: Chapter Id description: Limit the track to this chapter. Omit to span the whole project. volume: type: number maximum: 2 minimum: 0 title: Volume default: 1 description: Track volume, from 0 to 2. muted: type: boolean title: Muted default: false description: Whether the track is muted. additionalProperties: false type: object required: - expected_edit_token - operation_id - name title: TrackCreate ProjectResult: properties: project: $ref: '#/components/schemas/ProjectView' description: The project after this request. edit_token: type: string title: Edit Token description: >- Current edit_token. Send it as expected_edit_token on the next write. client_refs: additionalProperties: type: string type: object title: Client Refs description: 'Import only: each client_ref mapped to its created ID.' created_ids: items: type: string type: array title: Created Ids description: IDs created by this request, in order. additionalProperties: false type: object required: - project - edit_token title: ProjectResult ErrorResponse: properties: ok: default: false title: Ok type: boolean code: title: Code type: string detail: title: Detail type: string error: title: Error type: string meta: anyOf: - additionalProperties: true type: object - type: 'null' default: null title: Meta required: - code - detail - error title: ErrorResponse type: object ValidationErrorResponse: properties: ok: default: false title: Ok type: boolean code: title: Code type: string detail: title: Detail type: string error: title: Error type: string meta: anyOf: - additionalProperties: true type: object - type: 'null' title: Meta required: - code - detail - error title: ValidationErrorResponse type: object ProjectView: properties: id: type: string title: Id description: Project ID. title: type: string title: Title description: Project title. description: type: string title: Description description: Project description. tts_settings: anyOf: - $ref: '#/components/schemas/TtsSettingsView' - type: 'null' description: TTS model and language settings. default_voice_id: anyOf: - type: string - type: 'null' title: Default Voice Id description: Voice given to new clips that do not set voice_id. default_instructions: type: string title: Default Instructions description: Delivery instructions for clips with empty instructions. default_silence_ms: type: integer title: Default Silence Ms description: >- Silence after each clip in milliseconds, unless the clip sets trailing_silence_ms. edit_token: type: string title: Edit Token description: Current edit_token. created_at: type: string title: Created At description: Creation time (ISO 8601). updated_at: type: string title: Updated At description: Last update time (ISO 8601). chapter_count: type: integer title: Chapter Count description: Number of active chapters. clip_count: type: integer title: Clip Count description: Number of clips in active chapters. additionalProperties: false type: object required: - id - title - description - tts_settings - default_voice_id - default_instructions - default_silence_ms - edit_token - created_at - updated_at - chapter_count - clip_count title: ProjectView TtsSettingsView: properties: model: anyOf: - type: string - type: 'null' title: Model description: TTS model ID from List models. language: anyOf: - type: string - type: 'null' title: Language description: Project language code. generation_language: anyOf: - type: string - type: 'null' title: Generation Language description: >- Language code sent with each generation. null lets the model detect the language. guidance_scale: anyOf: - type: number - type: 'null' title: Guidance Scale description: 'Generation guidance strength. Accepted range: 1.0 to 10.0.' additionalProperties: false type: object title: TtsSettingsView securitySchemes: ApiKeyAuth: type: apiKey in: header name: xi-api-key description: Breeze Developer API key. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.