cURL
curl \
--request POST \
--url "https://api.breeze.blue/v1/studio/projects/import" \
--header "xi-api-key: $BREEZE_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"title": "An evening story",
"operation_id": "123e4567-e89b-42d3-a456-426614174000",
"chapters": [
{
"client_ref": "opening",
"title": "Opening",
"clips": [
{
"client_ref": "opening.line1",
"script": "The lights came on."
}
]
}
]
}'from breeze_blue import BreezeBlue
client = BreezeBlue()
result = client.studio.projects.import_project({
"title": "An evening story",
"operation_id": "123e4567-e89b-42d3-a456-426614174000",
"chapters": [
{
"client_ref": "opening",
"title": "Opening",
"clips": [
{
"client_ref": "opening.line1",
"script": "The lights came on.",
},
],
},
],
})import { BreezeBlueClient } from "@breeze.blue/sdk";
const client = new BreezeBlueClient();
const result = await client.studio.projects.importProject({
title: "An evening story",
operationId: "123e4567-e89b-42d3-a456-426614174000",
chapters: [{
clientRef: "opening",
title: "Opening",
clips: [{
clientRef: "opening.line1",
script: "The lights came on.",
}],
}],
});{
"project": {
"id": "<string>",
"title": "<string>",
"description": "<string>",
"tts_settings": {
"model": "<string>",
"language": "<string>",
"generation_language": "<string>",
"guidance_scale": 123
},
"default_voice_id": "<string>",
"default_instructions": "<string>",
"default_silence_ms": 123,
"edit_token": "<string>",
"created_at": "<string>",
"updated_at": "<string>",
"chapter_count": 123,
"clip_count": 123
},
"edit_token": "<string>",
"client_refs": {},
"created_ids": [
"<string>"
]
}{
"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": {}
}{
"code": "<string>",
"detail": "<string>",
"error": "<string>",
"ok": false,
"meta": {}
}Studio
Import a project
Create a project from a complete script in one step: up to 50 chapters with up to 400 clips each. Every voice is checked before anything is created. client_refs in the response maps each client_ref to the created chapter or clip ID. Requires a paid Studio subscription and a free saved-project slot.
POST
/
v1
/
studio
/
projects
/
import
cURL
curl \
--request POST \
--url "https://api.breeze.blue/v1/studio/projects/import" \
--header "xi-api-key: $BREEZE_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"title": "An evening story",
"operation_id": "123e4567-e89b-42d3-a456-426614174000",
"chapters": [
{
"client_ref": "opening",
"title": "Opening",
"clips": [
{
"client_ref": "opening.line1",
"script": "The lights came on."
}
]
}
]
}'from breeze_blue import BreezeBlue
client = BreezeBlue()
result = client.studio.projects.import_project({
"title": "An evening story",
"operation_id": "123e4567-e89b-42d3-a456-426614174000",
"chapters": [
{
"client_ref": "opening",
"title": "Opening",
"clips": [
{
"client_ref": "opening.line1",
"script": "The lights came on.",
},
],
},
],
})import { BreezeBlueClient } from "@breeze.blue/sdk";
const client = new BreezeBlueClient();
const result = await client.studio.projects.importProject({
title: "An evening story",
operationId: "123e4567-e89b-42d3-a456-426614174000",
chapters: [{
clientRef: "opening",
title: "Opening",
clips: [{
clientRef: "opening.line1",
script: "The lights came on.",
}],
}],
});{
"project": {
"id": "<string>",
"title": "<string>",
"description": "<string>",
"tts_settings": {
"model": "<string>",
"language": "<string>",
"generation_language": "<string>",
"guidance_scale": 123
},
"default_voice_id": "<string>",
"default_instructions": "<string>",
"default_silence_ms": 123,
"edit_token": "<string>",
"created_at": "<string>",
"updated_at": "<string>",
"chapter_count": 123,
"clip_count": 123
},
"edit_token": "<string>",
"client_refs": {},
"created_ids": [
"<string>"
]
}{
"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": {}
}{
"code": "<string>",
"detail": "<string>",
"error": "<string>",
"ok": false,
"meta": {}
}
