curl \
--request POST \
--url "https://api.breeze.blue/v1/studio/files" \
--header "xi-api-key: $BREEZE_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"operation_id": "123e4567-e89b-42d3-a456-426614174000",
"project_id": "prj_example",
"name": "background.mp3",
"size_bytes": 5242880,
"mime_type": "audio/mpeg"
}'from breeze_blue import BreezeBlue
client = BreezeBlue()
result = client.studio.files.create({
"operation_id": "123e4567-e89b-42d3-a456-426614174000",
"project_id": "prj_example",
"name": "background.mp3",
"size_bytes": 5242880,
"mime_type": "audio/mpeg",
})import { BreezeBlueClient } from "@breeze.blue/sdk";
const client = new BreezeBlueClient();
const result = await client.studio.files.create({
operationId: "123e4567-e89b-42d3-a456-426614174000",
projectId: "prj_example",
name: "background.mp3",
sizeBytes: 5242880,
mimeType: "audio/mpeg",
});{
"id": "<string>",
"project_id": "<string>",
"name": "<string>",
"revision": 123,
"status": "uploading",
"frames": 123,
"sample_rate": 123,
"size_bytes": 123,
"error_code": "<string>",
"error_reason": "<string>",
"error_message": "<string>",
"references": 123
}{
"code": "<string>",
"detail": "<string>",
"error": "<string>",
"ok": false,
"meta": {}
}{
"code": "<string>",
"detail": "<string>",
"error": "<string>",
"ok": false,
"meta": {}
}{
"code": "<string>",
"detail": "<string>",
"error": "<string>",
"ok": false,
"meta": {}
}{
"code": "<string>",
"detail": "<string>",
"error": "<string>",
"ok": false,
"meta": {}
}{
"code": "<string>",
"detail": "<string>",
"error": "<string>",
"ok": false,
"meta": {}
}Create a file
Register an MP3 or WAV file of up to 1.5 GB before uploading it. Next, get an upload URL, upload the bytes, and complete the upload. Retrying with the same operation_id and body returns the same file.
curl \
--request POST \
--url "https://api.breeze.blue/v1/studio/files" \
--header "xi-api-key: $BREEZE_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"operation_id": "123e4567-e89b-42d3-a456-426614174000",
"project_id": "prj_example",
"name": "background.mp3",
"size_bytes": 5242880,
"mime_type": "audio/mpeg"
}'from breeze_blue import BreezeBlue
client = BreezeBlue()
result = client.studio.files.create({
"operation_id": "123e4567-e89b-42d3-a456-426614174000",
"project_id": "prj_example",
"name": "background.mp3",
"size_bytes": 5242880,
"mime_type": "audio/mpeg",
})import { BreezeBlueClient } from "@breeze.blue/sdk";
const client = new BreezeBlueClient();
const result = await client.studio.files.create({
operationId: "123e4567-e89b-42d3-a456-426614174000",
projectId: "prj_example",
name: "background.mp3",
sizeBytes: 5242880,
mimeType: "audio/mpeg",
});{
"id": "<string>",
"project_id": "<string>",
"name": "<string>",
"revision": 123,
"status": "uploading",
"frames": 123,
"sample_rate": 123,
"size_bytes": 123,
"error_code": "<string>",
"error_reason": "<string>",
"error_message": "<string>",
"references": 123
}{
"code": "<string>",
"detail": "<string>",
"error": "<string>",
"ok": false,
"meta": {}
}{
"code": "<string>",
"detail": "<string>",
"error": "<string>",
"ok": false,
"meta": {}
}{
"code": "<string>",
"detail": "<string>",
"error": "<string>",
"ok": false,
"meta": {}
}{
"code": "<string>",
"detail": "<string>",
"error": "<string>",
"ok": false,
"meta": {}
}{
"code": "<string>",
"detail": "<string>",
"error": "<string>",
"ok": false,
"meta": {}
}Continue building
Arrange background audio
Create an instance
Studio CLI
Authorizations
Breeze Developer API key.
Body
New UUID for each write. Retrying with the same ID and body returns the original result instead of repeating the write.
File name, without path separators.
1 - 200Exact upload size in bytes, up to 1.5 GB.
1 <= x <= 1610612736audio/mpeg for MP3 or audio/wav for WAV.
audio/mpeg, audio/wav Project that owns the file. Omit for a personal file.
1 - 128\SResponse
The created file, with status uploading.
File ID.
Project that owns the file; null for a personal file.
File name.
Current revision. Send it as expected_revision to rename or delete.
uploading until the upload is completed, then queued and running while processing, and finally ready or failed.
uploading, queued, running, ready, failed Length in frames at sample_rate, once processed.
Frame rate used for all Studio timing: 48000.
Original upload size in bytes.
Error code when processing failed.
Machine-readable failure reason.
Readable failure message.
Number of instances that use the file.

