{"openapi":"3.1.0","info":{"title":"RunAPI API","version":"v1","description":"Create and retrieve AI media tasks, or use compatible LLM protocol endpoints."},"servers":[{"url":"https://runapi.ai"}],"security":[{"bearerAuth":[]}],"paths":{"/api/v1/audio_exports":{"post":{"tags":["Suno"],"summary":"Suno Audio-Exports","description":"Create an asynchronous task through the Suno audio exports endpoint.","operationId":"task_endpoint_suno_audio_exports","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"source_audio_id":{"type":"string","description":"Audio id within the source Task, or a RunAPI audio resource id returned by a previous request."},"source_task_id":{"type":"string","description":"RunAPI Task id that produced the audio. Required when the audio id alone does not identify the source."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."}},"additionalProperties":false,"required":["source_audio_id"]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/audio_exports/{id}":{"get":{"tags":["Suno"],"summary":"Retrieve Suno Audio-Exports task","description":"Create an asynchronous task through the Suno audio exports endpoint.","operationId":"task_endpoint_suno_audio_exports_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"wav_url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false},{"type":"object","required":["id","status","wav_url","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"wav_url":{"type":"string","x-runapi-generated-media":true},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/elevenlabs/isolate_audio/{id}":{"get":{"tags":["ElevenLabs"],"summary":"Retrieve ElevenLabs Isolate-Audio task","description":"This endpoint is retired. New requests return HTTP 410. Existing tasks remain queryable.","operationId":"task_endpoint_elevenlabs_isolate_audio_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","audios","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"audios":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/elevenlabs/speech_to_text/{id}":{"get":{"tags":["ElevenLabs"],"summary":"Retrieve ElevenLabs Speech-to-Text task","description":"This endpoint is retired. New requests return HTTP 410. Existing tasks remain queryable.","operationId":"task_endpoint_elevenlabs_speech_to_text_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","text","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"text":{"type":"string"},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/elevenlabs/text_to_dialogue":{"post":{"tags":["ElevenLabs"],"summary":"ElevenLabs Text-to-Dialogue","description":"Create an asynchronous task through the ElevenLabs text to dialogue endpoint.","operationId":"task_endpoint_elevenlabs_text_to_dialogue","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"dialogue":{"type":"array"},"callback_url":{"type":"string"},"stability":{"type":"number","enum":[0.0,0.5,1.0]},"language_code":{"type":"string"},"model":{"type":"string","const":"text-to-dialogue-v3"}},"additionalProperties":false,"required":["dialogue","model"]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/elevenlabs/text_to_dialogue/{id}":{"get":{"tags":["ElevenLabs"],"summary":"Retrieve ElevenLabs Text-to-Dialogue task","description":"Create an asynchronous task through the ElevenLabs text to dialogue endpoint.","operationId":"task_endpoint_elevenlabs_text_to_dialogue_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","audios","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"audios":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/elevenlabs/text_to_sound/{id}":{"get":{"tags":["ElevenLabs"],"summary":"Retrieve ElevenLabs Text-to-Sound task","description":"This endpoint is retired. New requests return HTTP 410. Existing tasks remain queryable.","operationId":"task_endpoint_elevenlabs_text_to_sound_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","audios","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"audios":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/elevenlabs/text_to_speech":{"post":{"tags":["ElevenLabs"],"summary":"ElevenLabs Text-to-Speech","description":"Create an asynchronous task through the ElevenLabs text to speech endpoint.","operationId":"task_endpoint_elevenlabs_text_to_speech","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"text-to-speech-multilingual-v2"},"text":{"type":"string"},"voice":{"type":"string"},"callback_url":{"type":"string"},"stability":{"type":"number"},"similarity_boost":{"type":"number"},"style":{"type":"number"},"speed":{"type":"number"},"timestamps":{"type":"boolean"},"previous_text":{"type":"string"},"next_text":{"type":"string"},"language_code":{"type":"string"}},"additionalProperties":false,"required":["model","text"],"allOf":[{"if":{"properties":{"model":{"const":"text-to-speech-multilingual-v2"}},"required":["model"]},"then":{"required":["voice"]}}]},{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"text-to-speech-turbo-v2.5"},"text":{"type":"string"},"voice":{"type":"string"},"callback_url":{"type":"string"},"stability":{"type":"number"},"similarity_boost":{"type":"number"},"style":{"type":"number"},"speed":{"type":"number"},"timestamps":{"type":"boolean"},"previous_text":{"type":"string"},"next_text":{"type":"string"},"language_code":{"type":"string"}},"additionalProperties":false,"required":["model","text"],"allOf":[{"if":{"properties":{"model":{"const":"text-to-speech-multilingual-v2"}},"required":["model"]},"then":{"required":["voice"]}}]}]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/elevenlabs/text_to_speech/{id}":{"get":{"tags":["ElevenLabs"],"summary":"Retrieve ElevenLabs Text-to-Speech task","description":"Create an asynchronous task through the ElevenLabs text to speech endpoint.","operationId":"task_endpoint_elevenlabs_text_to_speech_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","audios","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"audios":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/fish_audio/text_to_speech":{"post":{"tags":["Fish Audio"],"summary":"Fish Audio Text-to-Speech","description":"Send a synchronous request through the Fish Audio text to speech endpoint.","operationId":"task_endpoint_fish_audio_text_to_speech","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"s1"},"text":{"type":"string"},"output_format":{"type":"string","enum":["mp3","wav"],"default":"mp3","description":"Output audio format."},"sample_rate_hz":{"type":"integer","enum":[8000,16000,24000,32000,44100],"default":44100,"description":"Output sample rate. MP3 supports 32000 and 44100 Hz; WAV supports every listed value."},"bitrate_kbps":{"type":"integer","enum":[64,128,192],"default":128,"description":"MP3 bitrate. Not accepted for WAV output."},"references":{"type":["array","null"],"items":{"type":"object","properties":{"text":{"type":"string","description":"Exact transcript that matches the reference audio word for word."},"audio":{"type":"string","pattern":"^https://","description":"Publicly accessible HTTPS audio URL. Must remain valid while queued and read by the provider."}},"required":["text","audio"]},"maxItems":1,"description":"One temporary voice-cloning sample. Cannot be combined with voice_id. Omit, use null, or [] for no sample."},"voice_id":{"type":"string"}},"additionalProperties":false,"required":["model","text"],"allOf":[{"if":{"required":["references"],"properties":{"references":{"type":"array","minItems":1}}},"then":{"not":{"required":["voice_id"],"properties":{"voice_id":{"type":"string","pattern":"\\S"}}}}},{"if":{"properties":{"output_format":{"const":"wav"}},"required":["output_format"]},"then":{"not":{"required":["bitrate_kbps"]}}},{"if":{"properties":{"output_format":{"const":"mp3"}},"required":["output_format"]},"then":{"properties":{"sample_rate_hz":{"enum":[32000,44100]}}}},{"if":{"not":{"required":["output_format"]}},"then":{"properties":{"sample_rate_hz":{"enum":[32000,44100]}}}}]},{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"s2-pro"},"text":{"type":"string"},"output_format":{"type":"string","enum":["mp3","wav"],"default":"mp3","description":"Output audio format."},"sample_rate_hz":{"type":"integer","enum":[8000,16000,24000,32000,44100],"default":44100,"description":"Output sample rate. MP3 supports 32000 and 44100 Hz; WAV supports every listed value."},"bitrate_kbps":{"type":"integer","enum":[64,128,192],"default":128,"description":"MP3 bitrate. Not accepted for WAV output."},"references":{"type":["array","null"],"items":{"type":"object","properties":{"text":{"type":"string","description":"Exact transcript that matches the reference audio word for word."},"audio":{"type":"string","pattern":"^https://","description":"Publicly accessible HTTPS audio URL. Must remain valid while queued and read by the provider."}},"required":["text","audio"]},"maxItems":1,"description":"One temporary voice-cloning sample. Cannot be combined with voice_id. Omit, use null, or [] for no sample."},"voice_id":{"type":"string"}},"additionalProperties":false,"required":["model","text"],"allOf":[{"if":{"required":["references"],"properties":{"references":{"type":"array","minItems":1}}},"then":{"not":{"required":["voice_id"],"properties":{"voice_id":{"type":"string","pattern":"\\S"}}}}},{"if":{"properties":{"output_format":{"const":"wav"}},"required":["output_format"]},"then":{"not":{"required":["bitrate_kbps"]}}},{"if":{"properties":{"output_format":{"const":"mp3"}},"required":["output_format"]},"then":{"properties":{"sample_rate_hz":{"enum":[32000,44100]}}}},{"if":{"not":{"required":["output_format"]}},"then":{"properties":{"sample_rate_hz":{"enum":[32000,44100]}}}}]},{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"s2.1-pro"},"text":{"type":"string"},"output_format":{"type":"string","enum":["mp3","wav"],"default":"mp3","description":"Output audio format."},"sample_rate_hz":{"type":"integer","enum":[8000,16000,24000,32000,44100],"default":44100,"description":"Output sample rate. MP3 supports 32000 and 44100 Hz; WAV supports every listed value."},"bitrate_kbps":{"type":"integer","enum":[64,128,192],"default":128,"description":"MP3 bitrate. Not accepted for WAV output."},"references":{"type":["array","null"],"items":{"type":"object","properties":{"text":{"type":"string","description":"Exact transcript that matches the reference audio word for word."},"audio":{"type":"string","pattern":"^https://","description":"Publicly accessible HTTPS audio URL. Must remain valid while queued and read by the provider."}},"required":["text","audio"]},"maxItems":1,"description":"One temporary voice-cloning sample. Cannot be combined with voice_id. Omit, use null, or [] for no sample."},"voice_id":{"type":"string"}},"additionalProperties":false,"required":["model","text"],"allOf":[{"if":{"required":["references"],"properties":{"references":{"type":"array","minItems":1}}},"then":{"not":{"required":["voice_id"],"properties":{"voice_id":{"type":"string","pattern":"\\S"}}}}},{"if":{"properties":{"output_format":{"const":"wav"}},"required":["output_format"]},"then":{"not":{"required":["bitrate_kbps"]}}},{"if":{"properties":{"output_format":{"const":"mp3"}},"required":["output_format"]},"then":{"properties":{"sample_rate_hz":{"enum":[32000,44100]}}}},{"if":{"not":{"required":["output_format"]}},"then":{"properties":{"sample_rate_hz":{"enum":[32000,44100]}}}}]}]}}}},"responses":{"200":{"description":"Sync success","content":{"application/json":{"schema":{"type":"object","required":["id","status","audios"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"audios":{"type":"array","items":{"type":"object","required":["url","format","mime_type","size_bytes"],"properties":{"url":{"type":"string","x-runapi-generated-media":true},"format":{"type":"string"},"mime_type":{"type":"string"},"size_bytes":{"type":"integer"}},"unevaluatedProperties":false}}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/fish_audio/voices":{"post":{"tags":["Fish Audio"],"summary":"Fish Audio Create-Voice","description":"Send a synchronous request through the Fish Audio create voice endpoint.","operationId":"task_endpoint_fish_audio_create_voice","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"source_audio_url":{"type":"string"}},"additionalProperties":false,"required":["name","source_audio_url"]}}}},"responses":{"200":{"description":"Sync success","content":{"application/json":{"schema":{"type":"object","required":["voice"],"properties":{"voice":{"type":"object","properties":{"voice_id":{"type":"string"},"name":{"type":"string"},"state":{"type":"string","enum":["created","training","trained","failed"]}},"unevaluatedProperties":false}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}},"get":{"tags":["Fish Audio"],"summary":"Fish Audio List-Voices","description":"Send a synchronous request through the Fish Audio list voices endpoint.","operationId":"task_endpoint_fish_audio_list_voices","security":[{"bearerAuth":[]}],"parameters":[{"name":"page_number","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":10}}],"responses":{"200":{"description":"Sync success","content":{"application/json":{"schema":{"type":"object","required":["voices","total","page_number","page_size"],"properties":{"voices":{"type":"array","items":{"type":"object","required":["voice_id","state"],"properties":{"voice_id":{"type":"string"},"name":{"type":"string"},"state":{"type":"string","enum":["created","training","trained","failed"]}},"unevaluatedProperties":false}},"total":{"type":"integer"},"page_number":{"type":"integer"},"page_size":{"type":"integer"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/fish_audio/voices/{voice_id}":{"get":{"tags":["Fish Audio"],"summary":"Fish Audio Get-Voice","description":"Send a synchronous request through the Fish Audio get voice endpoint.","operationId":"task_endpoint_fish_audio_get_voice","security":[{"bearerAuth":[]}],"parameters":[{"name":"voice_id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sync success","content":{"application/json":{"schema":{"type":"object","required":["voice"],"properties":{"voice":{"type":"object","properties":{"voice_id":{"type":"string"},"name":{"type":"string"},"state":{"type":"string","enum":["created","training","trained","failed"]}},"unevaluatedProperties":false}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/flux/remix_image":{"post":{"tags":["Flux"],"summary":"Flux Remix-Image","description":"Create an asynchronous task through the Flux remix image endpoint.","operationId":"task_endpoint_flux_remix_image","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"model":{"type":"string","const":"flux-dev"},"prompt":{"type":"string","maxLength":5000,"minLength":3},"source_image_url":{"type":"string"},"aspect_ratio":{"type":"string","enum":["1:1","4:3","3:4","16:9","9:16","3:2","2:3"],"default":"1:1"},"output_count":{"type":"integer","enum":[1],"default":1},"callback_url":{"type":"string"}},"additionalProperties":false,"required":["prompt","source_image_url","model"]},{"type":"object","properties":{"model":{"type":"string","const":"flux-pro"},"prompt":{"type":"string","maxLength":5000,"minLength":3},"source_image_url":{"type":"string"},"aspect_ratio":{"type":"string","enum":["1:1","4:3","3:4","16:9","9:16","3:2","2:3"],"default":"1:1"},"output_count":{"type":"integer","enum":[1],"default":1},"callback_url":{"type":"string"}},"additionalProperties":false,"required":["prompt","source_image_url","model"]}]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/flux/remix_image/{id}":{"get":{"tags":["Flux"],"summary":"Retrieve Flux Remix-Image task","description":"Create an asynchronous task through the Flux remix image endpoint.","operationId":"task_endpoint_flux_remix_image_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","images","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"images":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/flux/text_to_image":{"post":{"tags":["Flux"],"summary":"Flux Text-to-Image","description":"Create an asynchronous task through the Flux text to image endpoint.","operationId":"task_endpoint_flux_text_to_image","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"model":{"type":"string","const":"flux-2-klein"},"prompt":{"type":"string","maxLength":5000,"minLength":3},"aspect_ratio":{"type":"string","enum":["1:1","4:3","3:4","16:9","9:16","3:2","2:3"],"default":"1:1"},"output_count":{"type":"integer","enum":[1],"default":1},"callback_url":{"type":"string"}},"additionalProperties":false,"required":["prompt","model"]},{"type":"object","properties":{"model":{"type":"string","const":"flux-dev"},"prompt":{"type":"string","maxLength":5000,"minLength":3},"aspect_ratio":{"type":"string","enum":["1:1","4:3","3:4","16:9","9:16","3:2","2:3"],"default":"1:1"},"output_count":{"type":"integer","enum":[1],"default":1},"callback_url":{"type":"string"}},"additionalProperties":false,"required":["prompt","model"]},{"type":"object","properties":{"model":{"type":"string","const":"flux-pro"},"prompt":{"type":"string","maxLength":5000,"minLength":3},"aspect_ratio":{"type":"string","enum":["1:1","4:3","3:4","16:9","9:16","3:2","2:3"],"default":"1:1"},"output_count":{"type":"integer","enum":[1],"default":1},"callback_url":{"type":"string"}},"additionalProperties":false,"required":["prompt","model"]}]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/flux/text_to_image/{id}":{"get":{"tags":["Flux"],"summary":"Retrieve Flux Text-to-Image task","description":"Create an asynchronous task through the Flux text to image endpoint.","operationId":"task_endpoint_flux_text_to_image_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","images","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"images":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/flux_2/remix_image":{"post":{"tags":["Flux 2"],"summary":"Flux 2 Remix-Image","description":"Create an asynchronous task through the Flux 2 remix image endpoint.","operationId":"task_endpoint_flux_2_remix_image","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"flux-2-flex-remix-image"},"prompt":{"type":"string","maxLength":5000,"minLength":3,"description":"Image editing instruction."},"source_image_urls":{"type":"array","maxItems":8,"minItems":1,"description":"Public source image URLs."},"aspect_ratio":{"type":"string","enum":["1:1","4:3","3:4","16:9","9:16","3:2","2:3","auto"],"default":"1:1","description":"Output aspect ratio."},"output_resolution":{"type":"string","enum":["1k","2k"],"default":"1k","description":"Output resolution."},"enable_safety_checker":{"type":"boolean","description":"Enable the safety checker."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."}},"additionalProperties":false,"required":["model","prompt","source_image_urls"],"allOf":[{"if":{"properties":{"model":{"const":"flux-2-flex-remix-image"}},"required":["model"]},"then":{"not":{"required":["output_count"]}}},{"if":{"properties":{"model":{"const":"flux-2-max-remix-image"}},"required":["model"]},"then":{"not":{"required":["enable_safety_checker"]}}},{"if":{"properties":{"model":{"const":"flux-2-pro-remix-image"}},"required":["model"]},"then":{"not":{"required":["output_count"]}}}]},{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"flux-2-max-remix-image"},"prompt":{"type":"string","maxLength":5000,"minLength":3,"description":"Image editing instruction."},"source_image_urls":{"type":"array","maxItems":1,"minItems":1,"description":"Exactly one public HTTP(S) source image URL."},"aspect_ratio":{"type":"string","enum":["1:1","4:3","3:4","16:9","9:16","3:2","2:3"],"description":"Output aspect ratio."},"output_resolution":{"type":"string","enum":["1k"],"default":"1k","description":"Output resolution."},"output_count":{"type":"integer","enum":[1],"default":1,"description":"Number of images to generate."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."}},"additionalProperties":false,"required":["model","prompt","source_image_urls","aspect_ratio"],"allOf":[{"if":{"properties":{"model":{"const":"flux-2-flex-remix-image"}},"required":["model"]},"then":{"not":{"required":["output_count"]}}},{"if":{"properties":{"model":{"const":"flux-2-max-remix-image"}},"required":["model"]},"then":{"not":{"required":["enable_safety_checker"]}}},{"if":{"properties":{"model":{"const":"flux-2-pro-remix-image"}},"required":["model"]},"then":{"not":{"required":["output_count"]}}}]},{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"flux-2-pro-remix-image"},"prompt":{"type":"string","maxLength":5000,"minLength":3,"description":"Image editing instruction."},"source_image_urls":{"type":"array","maxItems":8,"minItems":1,"description":"Public source image URLs."},"aspect_ratio":{"type":"string","enum":["1:1","4:3","3:4","16:9","9:16","3:2","2:3","auto"],"default":"1:1","description":"Output aspect ratio."},"output_resolution":{"type":"string","enum":["1k","2k"],"default":"1k","description":"Output resolution."},"enable_safety_checker":{"type":"boolean","description":"Enable the safety checker."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."}},"additionalProperties":false,"required":["model","prompt","source_image_urls"],"allOf":[{"if":{"properties":{"model":{"const":"flux-2-flex-remix-image"}},"required":["model"]},"then":{"not":{"required":["output_count"]}}},{"if":{"properties":{"model":{"const":"flux-2-max-remix-image"}},"required":["model"]},"then":{"not":{"required":["enable_safety_checker"]}}},{"if":{"properties":{"model":{"const":"flux-2-pro-remix-image"}},"required":["model"]},"then":{"not":{"required":["output_count"]}}}]}]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/flux_2/remix_image/{id}":{"get":{"tags":["Flux 2"],"summary":"Retrieve Flux 2 Remix-Image task","description":"Create an asynchronous task through the Flux 2 remix image endpoint.","operationId":"task_endpoint_flux_2_remix_image_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","images","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"images":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/flux_2/text_to_image":{"post":{"tags":["Flux 2"],"summary":"Flux 2 Text-to-Image","description":"Create an asynchronous task through the Flux 2 text to image endpoint.","operationId":"task_endpoint_flux_2_text_to_image","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"flux-2-flex-text-to-image"},"prompt":{"type":"string","maxLength":5000,"minLength":3,"description":"Image description."},"aspect_ratio":{"type":"string","enum":["1:1","4:3","3:4","16:9","9:16","3:2","2:3"],"default":"1:1","description":"Output aspect ratio."},"output_resolution":{"type":"string","enum":["1k","2k"],"default":"1k","description":"Output resolution."},"enable_safety_checker":{"type":"boolean","description":"Enable the safety checker."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."}},"additionalProperties":false,"required":["model","prompt"],"allOf":[{"if":{"properties":{"model":{"const":"flux-2-flex-text-to-image"}},"required":["model"]},"then":{"not":{"required":["output_count"]}}},{"if":{"properties":{"model":{"const":"flux-2-max-text-to-image"}},"required":["model"]},"then":{"not":{"required":["enable_safety_checker"]}}},{"if":{"properties":{"model":{"const":"flux-2-pro-text-to-image"}},"required":["model"]},"then":{"not":{"required":["output_count"]}}}]},{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"flux-2-max-text-to-image"},"prompt":{"type":"string","maxLength":5000,"minLength":3,"description":"Image description."},"aspect_ratio":{"type":"string","enum":["1:1","4:3","3:4","16:9","9:16","3:2","2:3"],"description":"Output aspect ratio."},"output_resolution":{"type":"string","enum":["1k"],"default":"1k","description":"Output resolution."},"output_count":{"type":"integer","enum":[1],"default":1,"description":"Number of images to generate."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."}},"additionalProperties":false,"required":["model","prompt","aspect_ratio"],"allOf":[{"if":{"properties":{"model":{"const":"flux-2-flex-text-to-image"}},"required":["model"]},"then":{"not":{"required":["output_count"]}}},{"if":{"properties":{"model":{"const":"flux-2-max-text-to-image"}},"required":["model"]},"then":{"not":{"required":["enable_safety_checker"]}}},{"if":{"properties":{"model":{"const":"flux-2-pro-text-to-image"}},"required":["model"]},"then":{"not":{"required":["output_count"]}}}]},{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"flux-2-pro-text-to-image"},"prompt":{"type":"string","maxLength":5000,"minLength":3,"description":"Image description."},"aspect_ratio":{"type":"string","enum":["1:1","4:3","3:4","16:9","9:16","3:2","2:3"],"default":"1:1","description":"Output aspect ratio."},"output_resolution":{"type":"string","enum":["1k","2k"],"default":"1k","description":"Output resolution."},"enable_safety_checker":{"type":"boolean","description":"Enable the safety checker."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."}},"additionalProperties":false,"required":["model","prompt"],"allOf":[{"if":{"properties":{"model":{"const":"flux-2-flex-text-to-image"}},"required":["model"]},"then":{"not":{"required":["output_count"]}}},{"if":{"properties":{"model":{"const":"flux-2-max-text-to-image"}},"required":["model"]},"then":{"not":{"required":["enable_safety_checker"]}}},{"if":{"properties":{"model":{"const":"flux-2-pro-text-to-image"}},"required":["model"]},"then":{"not":{"required":["output_count"]}}}]}]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/flux_2/text_to_image/{id}":{"get":{"tags":["Flux 2"],"summary":"Retrieve Flux 2 Text-to-Image task","description":"Create an asynchronous task through the Flux 2 text to image endpoint.","operationId":"task_endpoint_flux_2_text_to_image_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","images","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"images":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/flux_kontext/text_to_image":{"post":{"tags":["Flux Kontext"],"summary":"Flux Kontext Text-to-Image","description":"Create an asynchronous task through the Flux Kontext text to image endpoint.","operationId":"task_endpoint_flux_kontext_text_to_image","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"flux-kontext-max"},"prompt":{"type":"string","description":"Image description (English only)."},"aspect_ratio":{"type":"string","enum":["21:9","16:9","4:3","1:1","3:4","9:16"],"description":"Output aspect ratio. Default: 16:9."},"output_format":{"type":"string","enum":["jpeg","png"],"description":"Output format. Default: jpeg."},"source_image_url":{"type":"string","description":"Source image URL for editing mode."},"enable_translation":{"type":"boolean","description":"Auto-translate non-English prompts. Default: true."},"enable_prompt_expansion":{"type":"boolean","description":"Expand the prompt with more detail. Default: false."},"safety_tolerance":{"type":"integer","description":"Content safety threshold. 0-6 for generation, 0-2 for editing. Default: 2."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."},"watermark":{"type":"string","description":"Watermark identifier."}},"additionalProperties":false,"required":["model","prompt"]},{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"flux-kontext-pro"},"prompt":{"type":"string","description":"Image description (English only)."},"aspect_ratio":{"type":"string","enum":["21:9","16:9","4:3","1:1","3:4","9:16"],"description":"Output aspect ratio. Default: 16:9."},"output_format":{"type":"string","enum":["jpeg","png"],"description":"Output format. Default: jpeg."},"source_image_url":{"type":"string","description":"Source image URL for editing mode."},"enable_translation":{"type":"boolean","description":"Auto-translate non-English prompts. Default: true."},"enable_prompt_expansion":{"type":"boolean","description":"Expand the prompt with more detail. Default: false."},"safety_tolerance":{"type":"integer","description":"Content safety threshold. 0-6 for generation, 0-2 for editing. Default: 2."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."},"watermark":{"type":"string","description":"Watermark identifier."}},"additionalProperties":false,"required":["model","prompt"]}]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/flux_kontext/text_to_image/{id}":{"get":{"tags":["Flux Kontext"],"summary":"Retrieve Flux Kontext Text-to-Image task","description":"Create an asynchronous task through the Flux Kontext text to image endpoint.","operationId":"task_endpoint_flux_kontext_text_to_image_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","images","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"images":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true},"origin_url":{"type":"string"}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/gemini_omni/create_audio":{"post":{"tags":["Gemini Omni"],"summary":"Gemini Omni Create-Audio","description":"Send a synchronous request through the Gemini Omni create audio endpoint.","operationId":"task_endpoint_gemini_omni_create_audio","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"audio_id":{"type":"string","description":"Voice identity used for the audio preset."},"name":{"type":"string","maxLength":210,"description":"Audio preset display name."},"voice_description":{"type":"string","maxLength":20000,"description":"Voice characteristics such as pitch, tone, or accent."},"example_dialogue":{"type":"string","maxLength":120,"description":"Example dialogue demonstrating the voice style."},"model":{"type":"string","const":"gemini-omni-audio"}},"additionalProperties":false,"required":["audio_id","name","model"]}}}},"responses":{"200":{"description":"Sync success","content":{"application/json":{"schema":{"type":"object","required":["id","audio"],"properties":{"id":{"type":"string","description":"Created audio preset identifier."},"audio":{"type":"object","properties":{"id":{"type":"string","description":"Created audio preset identifier."},"name":{"type":"string","description":"Audio preset display name."}},"unevaluatedProperties":false}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/gemini_omni/create_character":{"post":{"tags":["Gemini Omni"],"summary":"Gemini Omni Create-Character","description":"Send a synchronous request through the Gemini Omni create character endpoint.","operationId":"task_endpoint_gemini_omni_create_character","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"descriptions":{"type":"string","maxLength":20000,"description":"Character appearance, identity, style, clothing, or personality description."},"reference_image_url":{"type":"string","description":"Public portrait reference image URL."},"body_reference_image_url":{"type":"string","description":"Optional public full-body reference image URL; reference_image_url must provide the portrait."},"audio_ids":{"type":"array","description":"Audio preset IDs returned by create-audio."},"character_name":{"type":"string","maxLength":210,"description":"Character display name."},"model":{"type":"string","const":"gemini-omni-character"}},"additionalProperties":false,"required":["descriptions","reference_image_url","model"]}}}},"responses":{"200":{"description":"Sync success","content":{"application/json":{"schema":{"type":"object","required":["id","character"],"properties":{"id":{"type":"string","description":"Created character identifier."},"character":{"type":"object","properties":{"id":{"type":"string","description":"Created character identifier."},"name":{"type":"string","description":"Character display name."},"images":{"type":"array","maxItems":2,"description":"Ordered character reference images; portrait first and optional full-body image second.","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}}},"unevaluatedProperties":false}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/gemini_omni/text_to_video":{"post":{"tags":["Gemini Omni"],"summary":"Gemini Omni Text-to-Video","description":"Create an asynchronous task through the Gemini Omni text to video endpoint.","operationId":"task_endpoint_gemini_omni_text_to_video","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"model":{"type":"string","description":"Model slug; defaults to gemini-omni-text-to-video when omitted.","const":"gemini-omni-flash-1-1"},"prompt":{"type":"string","maxLength":20000,"description":"Video generation prompt."},"duration_seconds":{"type":"integer","enum":[4,6,8,10],"description":"Output duration in seconds."},"callback_url":{"type":"string","description":"Webhook URL for terminal Task delivery."},"reference_image_urls":{"type":"array","maxItems":7,"description":"Public reference image URLs; images, video clips, and characters share a seven-unit reference limit."},"audio_ids":{"type":"array","maxItems":3,"description":"Audio preset IDs returned by create-audio."},"video_list":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","description":"Public source video URL."},"ends":{"minimum":0,"type":"number","description":"Clip end time in seconds; must be greater than start and no more than 10 seconds after start."},"start":{"minimum":0,"type":"number","description":"Clip start time in seconds."}},"required":["url","ends","start"]},"maxItems":1,"description":"Source video clips; each clip consumes two reference units."},"character_ids":{"type":"array","maxItems":3,"description":"Character IDs returned by create-character; dual-image characters consume two of the shared seven reference units."},"first_frame_image_url":{"type":"string","pattern":"^https?://","description":"Public first-frame image URL; mutually exclusive with reference images, audio IDs, video clips, and character IDs."},"last_frame_image_url":{"type":"string","pattern":"^https?://","description":"Public last-frame image URL; requires first_frame_image_url."},"aspect_ratio":{"type":"string","enum":["16:9","9:16"],"description":"Output aspect ratio."},"output_resolution":{"type":"string","enum":["360p","720p","1080p","4k"],"default":"720p","description":"Output resolution."},"seed":{"type":"integer","maximum":2147483647,"minimum":0,"description":"Deterministic generation seed."}},"additionalProperties":false,"required":["prompt","duration_seconds","model"],"allOf":[{"if":{"allOf":[{"properties":{"model":{"const":"gemini-omni-flash-1-1"}},"required":["model"]},{"required":["first_frame_image_url"]}]},"then":{"allOf":[{"not":{"required":["reference_image_urls"]}},{"not":{"required":["audio_ids"]}},{"not":{"required":["video_list"]}},{"not":{"required":["character_ids"]}}]}},{"if":{"allOf":[{"properties":{"model":{"const":"gemini-omni-flash-1-1"}},"required":["model"]},{"required":["last_frame_image_url"]}]},"then":{"required":["first_frame_image_url"]}},{"if":{"properties":{"model":{"const":"gemini-omni-flash-preview"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["reference_image_urls"]}},{"not":{"required":["audio_ids"]}},{"not":{"required":["video_list"]}},{"not":{"required":["character_ids"]}},{"not":{"required":["first_frame_image_url"]}},{"not":{"required":["last_frame_image_url"]}},{"not":{"required":["duration_seconds"]}},{"not":{"required":["seed"]}}]}},{"if":{"properties":{"model":{"const":"gemini-omni-text-to-video"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["first_frame_image_url"]}},{"not":{"required":["last_frame_image_url"]}}]}}]},{"type":"object","properties":{"model":{"type":"string","description":"Model slug; defaults to gemini-omni-text-to-video when omitted.","const":"gemini-omni-flash-preview"},"prompt":{"type":"string","maxLength":20000,"description":"Video generation prompt."},"callback_url":{"type":"string","description":"Webhook URL for terminal Task delivery."},"aspect_ratio":{"type":"string","enum":["16:9","9:16"],"default":"16:9","description":"Output aspect ratio."},"output_resolution":{"type":"string","enum":["720p"],"default":"720p","description":"Output resolution."}},"additionalProperties":false,"required":["prompt","model"],"allOf":[{"if":{"allOf":[{"properties":{"model":{"const":"gemini-omni-flash-1-1"}},"required":["model"]},{"required":["first_frame_image_url"]}]},"then":{"allOf":[{"not":{"required":["reference_image_urls"]}},{"not":{"required":["audio_ids"]}},{"not":{"required":["video_list"]}},{"not":{"required":["character_ids"]}}]}},{"if":{"allOf":[{"properties":{"model":{"const":"gemini-omni-flash-1-1"}},"required":["model"]},{"required":["last_frame_image_url"]}]},"then":{"required":["first_frame_image_url"]}},{"if":{"properties":{"model":{"const":"gemini-omni-flash-preview"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["reference_image_urls"]}},{"not":{"required":["audio_ids"]}},{"not":{"required":["video_list"]}},{"not":{"required":["character_ids"]}},{"not":{"required":["first_frame_image_url"]}},{"not":{"required":["last_frame_image_url"]}},{"not":{"required":["duration_seconds"]}},{"not":{"required":["seed"]}}]}},{"if":{"properties":{"model":{"const":"gemini-omni-text-to-video"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["first_frame_image_url"]}},{"not":{"required":["last_frame_image_url"]}}]}}]},{"type":"object","properties":{"model":{"type":"string","default":"gemini-omni-text-to-video","description":"Model slug; defaults to gemini-omni-text-to-video when omitted.","const":"gemini-omni-text-to-video"},"prompt":{"type":"string","maxLength":20000,"description":"Video generation prompt."},"duration_seconds":{"type":"integer","enum":[4,6,8,10],"description":"Output duration in seconds."},"callback_url":{"type":"string","description":"Webhook URL for terminal Task delivery."},"reference_image_urls":{"type":"array","maxItems":7,"description":"Public reference image URLs; images, video clips, and characters share a seven-unit reference limit."},"audio_ids":{"type":"array","maxItems":3,"description":"Audio preset IDs returned by create-audio."},"video_list":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","description":"Public source video URL."},"ends":{"minimum":0,"type":"number","description":"Clip end time in seconds; must be greater than start and no more than 10 seconds after start."},"start":{"minimum":0,"type":"number","description":"Clip start time in seconds."}},"required":["url","ends","start"]},"maxItems":1,"description":"Source video clips; each clip consumes two reference units."},"character_ids":{"type":"array","maxItems":3,"description":"Character IDs returned by create-character; dual-image characters consume two of the shared seven reference units."},"aspect_ratio":{"type":"string","enum":["16:9","9:16"],"description":"Output aspect ratio."},"output_resolution":{"type":"string","enum":["720p","1080p","4k"],"default":"720p","description":"Output resolution."},"seed":{"type":"integer","maximum":2147483647,"minimum":0,"description":"Deterministic generation seed."}},"additionalProperties":false,"required":["prompt","duration_seconds","model"],"allOf":[{"if":{"allOf":[{"properties":{"model":{"const":"gemini-omni-flash-1-1"}},"required":["model"]},{"required":["first_frame_image_url"]}]},"then":{"allOf":[{"not":{"required":["reference_image_urls"]}},{"not":{"required":["audio_ids"]}},{"not":{"required":["video_list"]}},{"not":{"required":["character_ids"]}}]}},{"if":{"allOf":[{"properties":{"model":{"const":"gemini-omni-flash-1-1"}},"required":["model"]},{"required":["last_frame_image_url"]}]},"then":{"required":["first_frame_image_url"]}},{"if":{"properties":{"model":{"const":"gemini-omni-flash-preview"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["reference_image_urls"]}},{"not":{"required":["audio_ids"]}},{"not":{"required":["video_list"]}},{"not":{"required":["character_ids"]}},{"not":{"required":["first_frame_image_url"]}},{"not":{"required":["last_frame_image_url"]}},{"not":{"required":["duration_seconds"]}},{"not":{"required":["seed"]}}]}},{"if":{"properties":{"model":{"const":"gemini-omni-text-to-video"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["first_frame_image_url"]}},{"not":{"required":["last_frame_image_url"]}}]}}]}]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/gemini_omni/text_to_video/{id}":{"get":{"tags":["Gemini Omni"],"summary":"Retrieve Gemini Omni Text-to-Video task","description":"Create an asynchronous task through the Gemini Omni text to video endpoint.","operationId":"task_endpoint_gemini_omni_text_to_video_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","videos","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"videos":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/gemini_tts/text_to_speech":{"post":{"tags":["Gemini TTS"],"summary":"Gemini TTS Text-to-Speech","description":"Create an asynchronous task through the Gemini TTS text to speech endpoint.","operationId":"task_endpoint_gemini_tts_text_to_speech","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"gemini-2.5-pro-tts"},"temperature":{"type":"number","maximum":2,"minimum":0,"default":1,"description":"Sampling temperature."},"scene":{"type":"string","description":"Scene and recording environment."},"sample_context":{"type":"string","description":"Overall delivery context and tone."},"speakers":{"type":"array","items":{"type":"object","properties":{"pace":{"enum":["Natural","Rapid Fire","The Drift","Staccato"],"type":"string","description":"Speaker pace."},"style":{"enum":["Vocal Smile","Newscaster","Whisper","Empathetic","Promo/Hype","Deadpan"],"type":"string","description":"Speaker delivery style."},"accent":{"enum":["Neutral","American (Gen)","American (Valley)","American (South)","British (RP)","British (Brixton)","Transatlantic","Australian"],"type":"string","description":"Speaker accent."},"speaker_id":{"type":"string","pattern":"^Speaker [1-9][0-9]*$","description":"Unique identifier in Speaker N format."},"voice_name":{"enum":["Achernar","Achird","Algenib","Algieba","Alnilam","Aoede","Autonoe","Callirrhoe","Charon","Despina","Enceladus","Erinome","Fenrir","Gacrux","Iapetus","Kore","Laomedeia","Leda","Orus","Puck","Pulcherrima","Rasalgethi","Sadachbia","Sadaltager","Schedar","Sulafat","Umbriel","Vindemiatrix","Zephyr","Zubenelgenubi"],"type":"string","description":"Preset voice name."},"audio_profile":{"type":"string","description":"Optional voice character guidance."}},"required":["speaker_id","voice_name"]},"minItems":1,"description":"Non-empty speaker configurations with unique Speaker N identifiers."},"dialogue_turns":{"type":"array","items":{"type":"object","properties":{"text":{"maxLength":10000,"type":"string","description":"Spoken text, up to 10,000 characters."},"speaker_id":{"type":"string","description":"Identifier matching a configured speakers[].speaker_id."}},"required":["text","speaker_id"]},"minItems":1,"description":"Non-empty ordered dialogue turns whose speaker ids reference configured speakers."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."}},"additionalProperties":false,"required":["model","speakers","dialogue_turns"]},{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"gemini-3.1-flash-tts"},"temperature":{"type":"number","maximum":2,"minimum":0,"default":1,"description":"Sampling temperature."},"scene":{"type":"string","description":"Scene and recording environment."},"sample_context":{"type":"string","description":"Overall delivery context and tone."},"speakers":{"type":"array","items":{"type":"object","properties":{"pace":{"enum":["Natural","Rapid Fire","The Drift","Staccato"],"type":"string","description":"Speaker pace."},"style":{"enum":["Vocal Smile","Newscaster","Whisper","Empathetic","Promo/Hype","Deadpan"],"type":"string","description":"Speaker delivery style."},"accent":{"enum":["Neutral","American (Gen)","American (Valley)","American (South)","British (RP)","British (Brixton)","Transatlantic","Australian"],"type":"string","description":"Speaker accent."},"speaker_id":{"type":"string","pattern":"^Speaker [1-9][0-9]*$","description":"Unique identifier in Speaker N format."},"voice_name":{"enum":["Achernar","Achird","Algenib","Algieba","Alnilam","Aoede","Autonoe","Callirrhoe","Charon","Despina","Enceladus","Erinome","Fenrir","Gacrux","Iapetus","Kore","Laomedeia","Leda","Orus","Puck","Pulcherrima","Rasalgethi","Sadachbia","Sadaltager","Schedar","Sulafat","Umbriel","Vindemiatrix","Zephyr","Zubenelgenubi"],"type":"string","description":"Preset voice name."},"audio_profile":{"type":"string","description":"Optional voice character guidance."}},"required":["speaker_id","voice_name"]},"minItems":1,"description":"Non-empty speaker configurations with unique Speaker N identifiers."},"dialogue_turns":{"type":"array","items":{"type":"object","properties":{"text":{"maxLength":10000,"type":"string","description":"Spoken text, up to 10,000 characters."},"speaker_id":{"type":"string","description":"Identifier matching a configured speakers[].speaker_id."}},"required":["text","speaker_id"]},"minItems":1,"description":"Non-empty ordered dialogue turns whose speaker ids reference configured speakers."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."}},"additionalProperties":false,"required":["model","speakers","dialogue_turns"]}]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/gemini_tts/text_to_speech/{id}":{"get":{"tags":["Gemini TTS"],"summary":"Retrieve Gemini TTS Text-to-Speech task","description":"Create an asynchronous task through the Gemini TTS text to speech endpoint.","operationId":"task_endpoint_gemini_tts_text_to_speech_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","audios","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"audios":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/gpt_4o_image/text_to_image":{"post":{"tags":["GPT-4o Image"],"summary":"GPT-4o Image Text-to-Image","description":"Create an asynchronous task through the GPT-4o Image text to image endpoint.","operationId":"task_endpoint_gpt_4o_image_text_to_image","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"model":{"type":"string","const":"gpt-4o-image"},"prompt":{"type":"string"},"aspect_ratio":{"type":"string","enum":["1:1","3:2","2:3"]},"source_image_urls":{"type":"array","maxItems":5},"mask_url":{"type":"string"},"output_count":{"type":"integer","enum":[1,2,4],"default":1},"callback_url":{"type":"string"},"enable_prompt_expansion":{"type":"boolean"}},"additionalProperties":false,"required":["aspect_ratio","model"]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/gpt_4o_image/text_to_image/{id}":{"get":{"tags":["GPT-4o Image"],"summary":"Retrieve GPT-4o Image Text-to-Image task","description":"Create an asynchronous task through the GPT-4o Image text to image endpoint.","operationId":"task_endpoint_gpt_4o_image_text_to_image_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"progress":{"type":"string"}},"unevaluatedProperties":false},{"type":"object","required":["id","status","images","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"images":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false},"progress":{"type":"string"}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/gpt_image/edit_image":{"post":{"tags":["GPT Image"],"summary":"GPT Image Edit-Image","description":"Create an asynchronous task through the GPT Image edit image endpoint.","operationId":"task_endpoint_gpt_image_edit_image","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"model":{"type":"string","const":"gpt-image-1.5"},"prompt":{"type":"string"},"source_image_urls":{"type":"array"},"aspect_ratio":{"type":"string","enum":["1:1","2:3","3:2"]},"quality":{"type":"string","enum":["medium","high"]},"callback_url":{"type":"string"}},"additionalProperties":false,"required":["prompt","source_image_urls","aspect_ratio","quality","model"]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status","task_replayed"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/gpt_image/edit_image/{id}":{"get":{"tags":["GPT Image"],"summary":"Retrieve GPT Image Edit-Image task","description":"Create an asynchronous task through the GPT Image edit image endpoint.","operationId":"task_endpoint_gpt_image_edit_image_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","images","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"images":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/gpt_image/text_to_image":{"post":{"tags":["GPT Image"],"summary":"GPT Image Text-to-Image","description":"Create an asynchronous task through the GPT Image text to image endpoint.","operationId":"task_endpoint_gpt_image_text_to_image","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"model":{"type":"string","const":"gpt-image-1.5"},"prompt":{"type":"string"},"aspect_ratio":{"type":"string","enum":["1:1","2:3","3:2"]},"quality":{"type":"string","enum":["medium","high"]},"callback_url":{"type":"string"}},"additionalProperties":false,"required":["prompt","aspect_ratio","quality","model"]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status","task_replayed"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/gpt_image/text_to_image/{id}":{"get":{"tags":["GPT Image"],"summary":"Retrieve GPT Image Text-to-Image task","description":"Create an asynchronous task through the GPT Image text to image endpoint.","operationId":"task_endpoint_gpt_image_text_to_image_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","images","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"images":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/gpt_image_2/edit_image":{"post":{"tags":["GPT Image 2"],"summary":"GPT Image 2 Edit-Image","description":"Create an asynchronous task through the GPT Image 2 edit image endpoint.","operationId":"task_endpoint_gpt_image_2_edit_image","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"model":{"type":"string","const":"gpt-image-2"},"prompt":{"type":"string"},"source_image_urls":{"type":"array"},"aspect_ratio":{"type":"string","enum":["auto","1:1","3:2","2:3","4:3","3:4","5:4","4:5","16:9","9:16","2:1","1:2","3:1","1:3","21:9","9:21"]},"output_resolution":{"type":"string","enum":["1k","2k","4k"],"default":"1k"},"background":{"type":"string","enum":["transparent","opaque","auto"]},"callback_url":{"type":"string"}},"additionalProperties":false,"required":["prompt","source_image_urls","model"]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status","task_replayed"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/gpt_image_2/edit_image/{id}":{"get":{"tags":["GPT Image 2"],"summary":"Retrieve GPT Image 2 Edit-Image task","description":"Create an asynchronous task through the GPT Image 2 edit image endpoint.","operationId":"task_endpoint_gpt_image_2_edit_image_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","images","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"images":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/gpt_image_2/text_to_image":{"post":{"tags":["GPT Image 2"],"summary":"GPT Image 2 Text-to-Image","description":"Create an asynchronous task through the GPT Image 2 text to image endpoint.","operationId":"task_endpoint_gpt_image_2_text_to_image","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"model":{"type":"string","const":"gpt-image-2"},"prompt":{"type":"string"},"aspect_ratio":{"type":"string","enum":["auto","1:1","3:2","2:3","4:3","3:4","5:4","4:5","16:9","9:16","2:1","1:2","3:1","1:3","21:9","9:21"]},"output_resolution":{"type":"string","enum":["1k","2k","4k"],"default":"1k"},"background":{"type":"string","enum":["transparent","opaque","auto"]},"callback_url":{"type":"string"}},"additionalProperties":false,"required":["prompt","model"]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status","task_replayed"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/gpt_image_2/text_to_image/{id}":{"get":{"tags":["GPT Image 2"],"summary":"Retrieve GPT Image 2 Text-to-Image task","description":"Create an asynchronous task through the GPT Image 2 text to image endpoint.","operationId":"task_endpoint_gpt_image_2_text_to_image_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","images","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"images":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/gpt_image_2_5/edit_image":{"post":{"tags":["GPT Image 2.5"],"summary":"GPT Image 2.5 Edit-Image","description":"Create an asynchronous task through the GPT Image 2.5 edit image endpoint.","operationId":"task_endpoint_gpt_image_2_5_edit_image","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"model":{"type":"string","const":"gpt-image-2.5-flare"},"prompt":{"type":"string"},"source_image_urls":{"type":"array","maxItems":16},"aspect_ratio":{"type":"string","enum":["auto","1:1","3:2","2:3","4:3","3:4","5:4","4:5","16:9","9:16","2:1","1:2","3:1","1:3","21:9","9:21"]},"output_resolution":{"type":"string","enum":["1k","2k","4k"],"default":"1k"},"background":{"type":"string","enum":["transparent","opaque","auto"]},"callback_url":{"type":"string"}},"additionalProperties":false,"required":["prompt","source_image_urls","model"],"allOf":[{"if":{"allOf":[{"properties":{"aspect_ratio":{"const":"1:1"}},"required":["aspect_ratio"]},{"properties":{"output_resolution":{"const":"4k"}},"required":["output_resolution"]}]},"then":{"not":{"required":["aspect_ratio"]}}},{"if":{"allOf":[{"properties":{"aspect_ratio":{"const":"auto"}},"required":["aspect_ratio"]},{"properties":{"output_resolution":{"const":"4k"}},"required":["output_resolution"]}]},"then":{"not":{"required":["aspect_ratio"]}}},{"if":{"allOf":[{"not":{"required":["aspect_ratio"]}},{"properties":{"output_resolution":{"const":"4k"}},"required":["output_resolution"]}]},"then":{"not":{"required":["output_resolution"]}}},{"if":{"allOf":[{"properties":{"aspect_ratio":{"const":"auto"}},"required":["aspect_ratio"]},{"properties":{"output_resolution":{"const":"2k"}},"required":["output_resolution"]}]},"then":{"not":{"required":["aspect_ratio"]}}},{"if":{"allOf":[{"not":{"required":["aspect_ratio"]}},{"properties":{"output_resolution":{"const":"2k"}},"required":["output_resolution"]}]},"then":{"not":{"required":["output_resolution"]}}}]},{"type":"object","properties":{"model":{"type":"string","const":"gpt-image-2.5-sunburst"},"prompt":{"type":"string"},"source_image_urls":{"type":"array","maxItems":16},"aspect_ratio":{"type":"string","enum":["auto","1:1","3:2","2:3","4:3","3:4","5:4","4:5","16:9","9:16","2:1","1:2","3:1","1:3","21:9","9:21"]},"output_resolution":{"type":"string","enum":["1k","2k","4k"],"default":"1k"},"background":{"type":"string","enum":["transparent","opaque","auto"]},"callback_url":{"type":"string"}},"additionalProperties":false,"required":["prompt","source_image_urls","model"],"allOf":[{"if":{"allOf":[{"properties":{"aspect_ratio":{"const":"1:1"}},"required":["aspect_ratio"]},{"properties":{"output_resolution":{"const":"4k"}},"required":["output_resolution"]}]},"then":{"not":{"required":["aspect_ratio"]}}},{"if":{"allOf":[{"properties":{"aspect_ratio":{"const":"auto"}},"required":["aspect_ratio"]},{"properties":{"output_resolution":{"const":"4k"}},"required":["output_resolution"]}]},"then":{"not":{"required":["aspect_ratio"]}}},{"if":{"allOf":[{"not":{"required":["aspect_ratio"]}},{"properties":{"output_resolution":{"const":"4k"}},"required":["output_resolution"]}]},"then":{"not":{"required":["output_resolution"]}}},{"if":{"allOf":[{"properties":{"aspect_ratio":{"const":"auto"}},"required":["aspect_ratio"]},{"properties":{"output_resolution":{"const":"2k"}},"required":["output_resolution"]}]},"then":{"not":{"required":["aspect_ratio"]}}},{"if":{"allOf":[{"not":{"required":["aspect_ratio"]}},{"properties":{"output_resolution":{"const":"2k"}},"required":["output_resolution"]}]},"then":{"not":{"required":["output_resolution"]}}}]}]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status","task_replayed"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/gpt_image_2_5/edit_image/{id}":{"get":{"tags":["GPT Image 2.5"],"summary":"Retrieve GPT Image 2.5 Edit-Image task","description":"Create an asynchronous task through the GPT Image 2.5 edit image endpoint.","operationId":"task_endpoint_gpt_image_2_5_edit_image_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","images","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"images":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/gpt_image_2_5/text_to_image":{"post":{"tags":["GPT Image 2.5"],"summary":"GPT Image 2.5 Text-to-Image","description":"Create an asynchronous task through the GPT Image 2.5 text to image endpoint.","operationId":"task_endpoint_gpt_image_2_5_text_to_image","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"model":{"type":"string","const":"gpt-image-2.5-flare"},"prompt":{"type":"string"},"aspect_ratio":{"type":"string","enum":["auto","1:1","3:2","2:3","4:3","3:4","5:4","4:5","16:9","9:16","2:1","1:2","3:1","1:3","21:9","9:21"]},"output_resolution":{"type":"string","enum":["1k","2k","4k"],"default":"1k"},"background":{"type":"string","enum":["transparent","opaque","auto"]},"callback_url":{"type":"string"}},"additionalProperties":false,"required":["prompt","model"],"allOf":[{"if":{"allOf":[{"properties":{"aspect_ratio":{"const":"1:1"}},"required":["aspect_ratio"]},{"properties":{"output_resolution":{"const":"4k"}},"required":["output_resolution"]}]},"then":{"not":{"required":["aspect_ratio"]}}},{"if":{"allOf":[{"properties":{"aspect_ratio":{"const":"auto"}},"required":["aspect_ratio"]},{"properties":{"output_resolution":{"const":"4k"}},"required":["output_resolution"]}]},"then":{"not":{"required":["aspect_ratio"]}}},{"if":{"allOf":[{"not":{"required":["aspect_ratio"]}},{"properties":{"output_resolution":{"const":"4k"}},"required":["output_resolution"]}]},"then":{"not":{"required":["output_resolution"]}}},{"if":{"allOf":[{"properties":{"aspect_ratio":{"const":"auto"}},"required":["aspect_ratio"]},{"properties":{"output_resolution":{"const":"2k"}},"required":["output_resolution"]}]},"then":{"not":{"required":["aspect_ratio"]}}},{"if":{"allOf":[{"not":{"required":["aspect_ratio"]}},{"properties":{"output_resolution":{"const":"2k"}},"required":["output_resolution"]}]},"then":{"not":{"required":["output_resolution"]}}}]},{"type":"object","properties":{"model":{"type":"string","const":"gpt-image-2.5-sunburst"},"prompt":{"type":"string"},"aspect_ratio":{"type":"string","enum":["auto","1:1","3:2","2:3","4:3","3:4","5:4","4:5","16:9","9:16","2:1","1:2","3:1","1:3","21:9","9:21"]},"output_resolution":{"type":"string","enum":["1k","2k","4k"],"default":"1k"},"background":{"type":"string","enum":["transparent","opaque","auto"]},"callback_url":{"type":"string"}},"additionalProperties":false,"required":["prompt","model"],"allOf":[{"if":{"allOf":[{"properties":{"aspect_ratio":{"const":"1:1"}},"required":["aspect_ratio"]},{"properties":{"output_resolution":{"const":"4k"}},"required":["output_resolution"]}]},"then":{"not":{"required":["aspect_ratio"]}}},{"if":{"allOf":[{"properties":{"aspect_ratio":{"const":"auto"}},"required":["aspect_ratio"]},{"properties":{"output_resolution":{"const":"4k"}},"required":["output_resolution"]}]},"then":{"not":{"required":["aspect_ratio"]}}},{"if":{"allOf":[{"not":{"required":["aspect_ratio"]}},{"properties":{"output_resolution":{"const":"4k"}},"required":["output_resolution"]}]},"then":{"not":{"required":["output_resolution"]}}},{"if":{"allOf":[{"properties":{"aspect_ratio":{"const":"auto"}},"required":["aspect_ratio"]},{"properties":{"output_resolution":{"const":"2k"}},"required":["output_resolution"]}]},"then":{"not":{"required":["aspect_ratio"]}}},{"if":{"allOf":[{"not":{"required":["aspect_ratio"]}},{"properties":{"output_resolution":{"const":"2k"}},"required":["output_resolution"]}]},"then":{"not":{"required":["output_resolution"]}}}]}]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status","task_replayed"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/gpt_image_2_5/text_to_image/{id}":{"get":{"tags":["GPT Image 2.5"],"summary":"Retrieve GPT Image 2.5 Text-to-Image task","description":"Create an asynchronous task through the GPT Image 2.5 text to image endpoint.","operationId":"task_endpoint_gpt_image_2_5_text_to_image_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","images","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"images":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/grok_imagine/edit_image":{"post":{"tags":["Grok Imagine"],"summary":"Grok Imagine Edit-Image","description":"Create an asynchronous task through the Grok Imagine edit image endpoint.","operationId":"task_endpoint_grok_imagine_edit_image","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"grok-imagine-edit-image"},"source_image_url":{"type":"string","description":"Public source image URL."},"callback_url":{"type":"string","description":"Webhook URL for terminal Task delivery."},"prompt":{"type":"string","description":"Optional image editing instruction."},"enable_safety_checker":{"type":"boolean","description":"Enable content safety checks."}},"additionalProperties":false,"required":["model","source_image_url"],"allOf":[{"if":{"properties":{"model":{"const":"grok-imagine-edit-image"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["source_task_id"]}},{"not":{"required":["mask_indices"]}},{"not":{"required":["source_image_urls"]}},{"not":{"required":["aspect_ratio"]}}]}},{"if":{"properties":{"model":{"const":"grok-imagine-image-2-0"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["source_image_url"]}},{"not":{"required":["source_task_id"]}},{"not":{"required":["mask_indices"]}},{"not":{"required":["enable_safety_checker"]}}]}}]},{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"grok-imagine-image-2-0"},"source_image_urls":{"type":"array","items":{"type":"string"},"maxItems":5,"minItems":1,"description":"Source image URLs, from one to five entries."},"callback_url":{"type":"string","description":"Webhook URL for terminal Task delivery."},"prompt":{"type":"string","maxLength":390000,"description":"Image editing prompt."},"aspect_ratio":{"type":"string","enum":["1:1","2:3","3:2","16:9","9:16","auto"],"description":"Output aspect ratio."}},"additionalProperties":false,"required":["model","source_image_urls","aspect_ratio"],"allOf":[{"if":{"properties":{"model":{"const":"grok-imagine-edit-image"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["source_task_id"]}},{"not":{"required":["mask_indices"]}},{"not":{"required":["source_image_urls"]}},{"not":{"required":["aspect_ratio"]}}]}},{"if":{"properties":{"model":{"const":"grok-imagine-image-2-0"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["source_image_url"]}},{"not":{"required":["source_task_id"]}},{"not":{"required":["mask_indices"]}},{"not":{"required":["enable_safety_checker"]}}]}}]}]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/grok_imagine/edit_image/{id}":{"get":{"tags":["Grok Imagine"],"summary":"Retrieve Grok Imagine Edit-Image task","description":"Create an asynchronous task through the Grok Imagine edit image endpoint.","operationId":"task_endpoint_grok_imagine_edit_image_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","images","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"images":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/grok_imagine/extend_video":{"post":{"tags":["Grok Imagine"],"summary":"Grok Imagine Extend","description":"Create an asynchronous task through the Grok Imagine extend endpoint.","operationId":"task_endpoint_grok_imagine_extend","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"source_task_id":{"type":"string","description":"Completed prior Grok Imagine video Task ID."},"prompt":{"type":"string","maxLength":5000,"description":"Video continuation prompt."},"start_seconds":{"type":"integer","minimum":0,"description":"Source video position in seconds where extension begins."},"extension_duration_seconds":{"type":"integer","enum":[6,10],"description":"Extension duration in seconds."},"callback_url":{"type":"string","description":"Webhook URL for terminal Task delivery."}},"additionalProperties":false,"required":["source_task_id","prompt","start_seconds","extension_duration_seconds"]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/grok_imagine/extend_video/{id}":{"get":{"tags":["Grok Imagine"],"summary":"Retrieve Grok Imagine Extend task","description":"Create an asynchronous task through the Grok Imagine extend endpoint.","operationId":"task_endpoint_grok_imagine_extend_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","videos","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"videos":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/grok_imagine/image_to_video":{"post":{"tags":["Grok Imagine"],"summary":"Grok Imagine Image-to-Video","description":"Create an asynchronous task through the Grok Imagine image to video endpoint.","operationId":"task_endpoint_grok_imagine_image_to_video","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"grok-imagine-image-to-video"},"callback_url":{"type":"string","description":"Webhook URL for terminal Task delivery."},"source_image_url":{"type":"string","description":"Public source image URL; provide this or source_task_id, but not both."},"source_task_id":{"type":"string","description":"Prior Grok Imagine text-to-image Task ID; provide this or source_image_url, but not both."},"index":{"type":"integer","maximum":1,"minimum":0,"description":"Zero-based source image index; used only with source_task_id."},"prompt":{"type":"string","maxLength":5000,"description":"Optional video generation prompt."},"motion_style":{"type":"string","enum":["fun","normal","spicy"],"description":"Video motion style; spicy requires source_task_id."},"duration_seconds":{"type":"integer","maximum":30,"minimum":6,"description":"Output duration in seconds."},"output_resolution":{"type":"string","enum":["480p","720p"],"default":"480p","description":"Output resolution."},"aspect_ratio":{"type":"string","enum":["2:3","3:2","1:1","16:9","9:16"],"description":"Output aspect ratio."},"enable_safety_checker":{"type":"boolean","description":"Enable content safety checks."}},"additionalProperties":false,"required":["model"],"allOf":[{"if":{"properties":{"model":{"const":"grok-imagine-image-to-video"}},"required":["model"]},"then":{"not":{"required":["reference_image_urls"]}}},{"if":{"properties":{"model":{"const":"grok-imagine-video-1.5-fast"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["source_task_id"]}},{"not":{"required":["index"]}},{"not":{"required":["motion_style"]}},{"not":{"required":["enable_safety_checker"]}}]}},{"if":{"properties":{"model":{"const":"grok-imagine-video-1.5-preview"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["source_task_id"]}},{"not":{"required":["index"]}},{"not":{"required":["motion_style"]}},{"not":{"required":["enable_safety_checker"]}}]}}]},{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"grok-imagine-video-1.5-fast"},"callback_url":{"type":"string","description":"Webhook URL for terminal Task delivery."},"source_image_url":{"type":"string","description":"Public source image URL."},"reference_image_urls":{"type":"array","description":"Public reference image URLs."},"prompt":{"type":"string","maxLength":5000,"description":"Optional video generation prompt."},"duration_seconds":{"type":"integer","maximum":30,"minimum":1,"default":8,"description":"Output duration in seconds."},"output_resolution":{"type":"string","enum":["480p","720p"],"default":"480p","description":"Output resolution."},"aspect_ratio":{"type":"string","enum":["1:1","16:9","9:16","3:2","2:3"],"description":"Output aspect ratio."}},"additionalProperties":false,"required":["model","source_image_url"],"allOf":[{"if":{"properties":{"model":{"const":"grok-imagine-image-to-video"}},"required":["model"]},"then":{"not":{"required":["reference_image_urls"]}}},{"if":{"properties":{"model":{"const":"grok-imagine-video-1.5-fast"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["source_task_id"]}},{"not":{"required":["index"]}},{"not":{"required":["motion_style"]}},{"not":{"required":["enable_safety_checker"]}}]}},{"if":{"properties":{"model":{"const":"grok-imagine-video-1.5-preview"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["source_task_id"]}},{"not":{"required":["index"]}},{"not":{"required":["motion_style"]}},{"not":{"required":["enable_safety_checker"]}}]}}]},{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"grok-imagine-video-1.5-preview"},"callback_url":{"type":"string","description":"Webhook URL for terminal Task delivery."},"source_image_url":{"type":"string","description":"Public source image URL."},"reference_image_urls":{"type":"array","maxItems":6,"description":"Additional public reference image URLs; source plus references may total seven images."},"prompt":{"type":"string","maxLength":4096,"minLength":1,"description":"Optional video generation prompt."},"duration_seconds":{"type":"integer","maximum":15,"minimum":1,"default":8,"description":"Output duration in seconds."},"output_resolution":{"type":"string","enum":["480p","720p","1080p"],"default":"480p","description":"Output resolution."},"aspect_ratio":{"type":"string","enum":["1:1","16:9","9:16","3:2","2:3","auto"],"default":"auto","description":"Output aspect ratio."}},"additionalProperties":false,"required":["model","source_image_url"],"allOf":[{"if":{"properties":{"model":{"const":"grok-imagine-image-to-video"}},"required":["model"]},"then":{"not":{"required":["reference_image_urls"]}}},{"if":{"properties":{"model":{"const":"grok-imagine-video-1.5-fast"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["source_task_id"]}},{"not":{"required":["index"]}},{"not":{"required":["motion_style"]}},{"not":{"required":["enable_safety_checker"]}}]}},{"if":{"properties":{"model":{"const":"grok-imagine-video-1.5-preview"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["source_task_id"]}},{"not":{"required":["index"]}},{"not":{"required":["motion_style"]}},{"not":{"required":["enable_safety_checker"]}}]}}]}]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/grok_imagine/image_to_video/{id}":{"get":{"tags":["Grok Imagine"],"summary":"Retrieve Grok Imagine Image-to-Video task","description":"Create an asynchronous task through the Grok Imagine image to video endpoint.","operationId":"task_endpoint_grok_imagine_image_to_video_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","videos","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"videos":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/grok_imagine/segment_map":{"post":{"tags":["Grok Imagine"],"summary":"Grok Imagine Segment-Map","description":"Create an asynchronous task through the Grok Imagine segment map endpoint.","operationId":"task_endpoint_grok_imagine_segment_map","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"grok-imagine-image-2-0"},"image_url":{"type":"string","description":"Public image URL that the service can fetch."},"source_task_id":{"type":"string","description":"Completed Image 2.0 text-to-image Task ID owned by the same account. Compatibility input; use image_url instead."},"callback_url":{"type":"string","description":"Webhook URL for terminal Task delivery."}},"additionalProperties":false,"required":["model"],"allOf":[{"if":{},"then":{"anyOf":[{"required":["image_url"]},{"required":["source_task_id"]}]}},{"if":{"required":["image_url"]},"then":{"not":{"required":["source_task_id"]}}},{"if":{"required":["source_task_id"]},"then":{"not":{"required":["image_url"]}}}]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/grok_imagine/segment_map/{id}":{"get":{"tags":["Grok Imagine"],"summary":"Retrieve Grok Imagine Segment-Map task","description":"Create an asynchronous task through the Grok Imagine segment map endpoint.","operationId":"task_endpoint_grok_imagine_segment_map_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","segments","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"segments":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true},"name":{"type":"string"},"index":{"type":"integer"}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/grok_imagine/text_to_image":{"post":{"tags":["Grok Imagine"],"summary":"Grok Imagine Text-to-Image","description":"Create an asynchronous task through the Grok Imagine text to image endpoint.","operationId":"task_endpoint_grok_imagine_text_to_image","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"grok-imagine-image-2-0"},"prompt":{"type":"string","description":"Image generation prompt."},"callback_url":{"type":"string","description":"Webhook URL for terminal Task delivery."},"aspect_ratio":{"type":"string","enum":["1:1","2:3","3:2","16:9","9:16"],"description":"Output aspect ratio."}},"additionalProperties":false,"required":["model","prompt","aspect_ratio"],"allOf":[{"if":{"properties":{"model":{"const":"grok-imagine-image-2-0"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["enable_safety_checker"]}},{"not":{"required":["enable_pro"]}}]}}]},{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"grok-imagine-text-to-image"},"prompt":{"type":"string","maxLength":5000,"description":"Image generation prompt."},"callback_url":{"type":"string","description":"Webhook URL for terminal Task delivery."},"aspect_ratio":{"type":"string","enum":["2:3","3:2","1:1","16:9","9:16"],"default":"1:1","description":"Output aspect ratio."},"enable_safety_checker":{"type":"boolean","description":"Enable content safety checks."},"enable_pro":{"type":"boolean","default":false,"description":"Enable Pro image generation mode."}},"additionalProperties":false,"required":["model","prompt"],"allOf":[{"if":{"properties":{"model":{"const":"grok-imagine-image-2-0"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["enable_safety_checker"]}},{"not":{"required":["enable_pro"]}}]}}]}]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/grok_imagine/text_to_image/{id}":{"get":{"tags":["Grok Imagine"],"summary":"Retrieve Grok Imagine Text-to-Image task","description":"Create an asynchronous task through the Grok Imagine text to image endpoint.","operationId":"task_endpoint_grok_imagine_text_to_image_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","images","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"images":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/grok_imagine/text_to_video":{"post":{"tags":["Grok Imagine"],"summary":"Grok Imagine Text-to-Video","description":"Create an asynchronous task through the Grok Imagine text to video endpoint.","operationId":"task_endpoint_grok_imagine_text_to_video","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"grok-imagine-text-to-video"},"prompt":{"type":"string","maxLength":5000,"description":"Video generation prompt."},"callback_url":{"type":"string","description":"Webhook URL for terminal Task delivery."},"aspect_ratio":{"type":"string","enum":["2:3","3:2","1:1","16:9","9:16"],"description":"Output aspect ratio."},"motion_style":{"type":"string","enum":["fun","normal","spicy"],"description":"Video motion style."},"duration_seconds":{"type":"integer","maximum":30,"minimum":6,"description":"Output duration in seconds."},"output_resolution":{"type":"string","enum":["480p","720p"],"default":"480p","description":"Output resolution."},"enable_safety_checker":{"type":"boolean","description":"Enable content safety checks."}},"additionalProperties":false,"required":["model","prompt"],"allOf":[{"if":{"properties":{"model":{"const":"grok-imagine-text-to-video"}},"required":["model"]},"then":{"not":{"required":["reference_image_urls"]}}},{"if":{"properties":{"model":{"const":"grok-imagine-video-1.5-fast"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["motion_style"]}},{"not":{"required":["enable_safety_checker"]}}]}},{"if":{"properties":{"model":{"const":"grok-imagine-video-1.5-preview"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["motion_style"]}},{"not":{"required":["enable_safety_checker"]}}]}}]},{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"grok-imagine-video-1.5-fast"},"prompt":{"type":"string","maxLength":5000,"description":"Video generation prompt."},"callback_url":{"type":"string","description":"Webhook URL for terminal Task delivery."},"reference_image_urls":{"type":"array","description":"Public reference image URLs."},"aspect_ratio":{"type":"string","enum":["1:1","16:9","9:16","3:2","2:3"],"description":"Output aspect ratio."},"duration_seconds":{"type":"integer","maximum":30,"minimum":1,"default":8,"description":"Output duration in seconds."},"output_resolution":{"type":"string","enum":["480p","720p"],"default":"480p","description":"Output resolution."}},"additionalProperties":false,"required":["model","prompt"],"allOf":[{"if":{"properties":{"model":{"const":"grok-imagine-text-to-video"}},"required":["model"]},"then":{"not":{"required":["reference_image_urls"]}}},{"if":{"properties":{"model":{"const":"grok-imagine-video-1.5-fast"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["motion_style"]}},{"not":{"required":["enable_safety_checker"]}}]}},{"if":{"properties":{"model":{"const":"grok-imagine-video-1.5-preview"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["motion_style"]}},{"not":{"required":["enable_safety_checker"]}}]}}]},{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"grok-imagine-video-1.5-preview"},"prompt":{"type":"string","maxLength":4096,"minLength":1,"description":"Video generation prompt."},"callback_url":{"type":"string","description":"Webhook URL for terminal Task delivery."},"reference_image_urls":{"type":"array","maxItems":7,"description":"Public reference image URLs; 1080p accepts at most one image."},"aspect_ratio":{"type":"string","enum":["1:1","16:9","9:16","3:2","2:3","auto"],"default":"auto","description":"Output aspect ratio."},"duration_seconds":{"type":"integer","maximum":15,"minimum":1,"default":8,"description":"Output duration in seconds."},"output_resolution":{"type":"string","enum":["480p","720p","1080p"],"default":"480p","description":"Output resolution."}},"additionalProperties":false,"required":["model","prompt"],"allOf":[{"if":{"properties":{"model":{"const":"grok-imagine-text-to-video"}},"required":["model"]},"then":{"not":{"required":["reference_image_urls"]}}},{"if":{"properties":{"model":{"const":"grok-imagine-video-1.5-fast"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["motion_style"]}},{"not":{"required":["enable_safety_checker"]}}]}},{"if":{"properties":{"model":{"const":"grok-imagine-video-1.5-preview"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["motion_style"]}},{"not":{"required":["enable_safety_checker"]}}]}}]}]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/grok_imagine/text_to_video/{id}":{"get":{"tags":["Grok Imagine"],"summary":"Retrieve Grok Imagine Text-to-Video task","description":"Create an asynchronous task through the Grok Imagine text to video endpoint.","operationId":"task_endpoint_grok_imagine_text_to_video_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","videos","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"videos":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/grok_imagine/upscale_image":{"post":{"tags":["Grok Imagine"],"summary":"Grok Imagine Upscale-Image","description":"Create an asynchronous task through the Grok Imagine upscale image endpoint.","operationId":"task_endpoint_grok_imagine_upscale_image","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"source_task_id":{"type":"string","description":"Completed prior Grok Imagine video Task ID."},"callback_url":{"type":"string","description":"Webhook URL for terminal Task delivery."}},"additionalProperties":false,"required":["source_task_id"]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/grok_imagine/upscale_image/{id}":{"get":{"tags":["Grok Imagine"],"summary":"Retrieve Grok Imagine Upscale-Image task","description":"Create an asynchronous task through the Grok Imagine upscale image endpoint.","operationId":"task_endpoint_grok_imagine_upscale_image_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","videos","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"videos":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/hailuo/image_to_video":{"post":{"tags":["Hailuo"],"summary":"Hailuo Image-to-Video","description":"Create an asynchronous task through the Hailuo image to video endpoint.","operationId":"task_endpoint_hailuo_image_to_video","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"model":{"type":"string","const":"hailuo-02-image-to-video-pro"},"prompt":{"type":"string"},"first_frame_image_url":{"type":"string"},"last_frame_image_url":{"type":"string"},"duration_seconds":{"type":"integer"},"output_resolution":{"type":"string"},"prompt_optimizer":{"type":"boolean"},"enable_safety_checker":{"type":"boolean","description":"Enable the safety checker."},"callback_url":{"type":"string"}},"additionalProperties":false,"required":["first_frame_image_url","model"],"allOf":[{"if":{"allOf":[{"properties":{"model":{"const":"hailuo-2.3-image-to-video-pro"}},"required":["model"]},{"properties":{"duration_seconds":{"const":10}},"required":["duration_seconds"]}]},"then":{"properties":{"output_resolution":{"enum":["768p"]}}}},{"if":{"allOf":[{"properties":{"model":{"const":"hailuo-2.3-image-to-video-standard"}},"required":["model"]},{"properties":{"duration_seconds":{"const":10}},"required":["duration_seconds"]}]},"then":{"properties":{"output_resolution":{"enum":["768p"]}}}}]},{"type":"object","properties":{"model":{"type":"string","const":"hailuo-02-image-to-video-standard"},"prompt":{"type":"string"},"first_frame_image_url":{"type":"string"},"last_frame_image_url":{"type":"string"},"duration_seconds":{"type":"integer","enum":[6,10],"default":10},"output_resolution":{"type":"string","enum":["512p","768p"],"default":"768p"},"prompt_optimizer":{"type":"boolean"},"enable_safety_checker":{"type":"boolean"},"callback_url":{"type":"string"}},"additionalProperties":false,"required":["first_frame_image_url","model"],"allOf":[{"if":{"allOf":[{"properties":{"model":{"const":"hailuo-2.3-image-to-video-pro"}},"required":["model"]},{"properties":{"duration_seconds":{"const":10}},"required":["duration_seconds"]}]},"then":{"properties":{"output_resolution":{"enum":["768p"]}}}},{"if":{"allOf":[{"properties":{"model":{"const":"hailuo-2.3-image-to-video-standard"}},"required":["model"]},{"properties":{"duration_seconds":{"const":10}},"required":["duration_seconds"]}]},"then":{"properties":{"output_resolution":{"enum":["768p"]}}}}]},{"type":"object","properties":{"model":{"type":"string","const":"hailuo-2.3-image-to-video-pro"},"prompt":{"type":"string"},"first_frame_image_url":{"type":"string"},"last_frame_image_url":{"type":"string"},"duration_seconds":{"type":"integer","enum":[6,10],"default":6},"output_resolution":{"type":"string","enum":["768p","1080p"],"default":"768p"},"prompt_optimizer":{"type":"boolean"},"enable_safety_checker":{"type":"boolean"},"callback_url":{"type":"string"}},"additionalProperties":false,"required":["first_frame_image_url","model"],"allOf":[{"if":{"allOf":[{"properties":{"model":{"const":"hailuo-2.3-image-to-video-pro"}},"required":["model"]},{"properties":{"duration_seconds":{"const":10}},"required":["duration_seconds"]}]},"then":{"properties":{"output_resolution":{"enum":["768p"]}}}},{"if":{"allOf":[{"properties":{"model":{"const":"hailuo-2.3-image-to-video-standard"}},"required":["model"]},{"properties":{"duration_seconds":{"const":10}},"required":["duration_seconds"]}]},"then":{"properties":{"output_resolution":{"enum":["768p"]}}}}]},{"type":"object","properties":{"model":{"type":"string","const":"hailuo-2.3-image-to-video-standard"},"prompt":{"type":"string"},"first_frame_image_url":{"type":"string"},"last_frame_image_url":{"type":"string"},"duration_seconds":{"type":"integer","enum":[6,10],"default":6},"output_resolution":{"type":"string","enum":["768p","1080p"],"default":"768p"},"prompt_optimizer":{"type":"boolean"},"enable_safety_checker":{"type":"boolean"},"callback_url":{"type":"string"}},"additionalProperties":false,"required":["first_frame_image_url","model"],"allOf":[{"if":{"allOf":[{"properties":{"model":{"const":"hailuo-2.3-image-to-video-pro"}},"required":["model"]},{"properties":{"duration_seconds":{"const":10}},"required":["duration_seconds"]}]},"then":{"properties":{"output_resolution":{"enum":["768p"]}}}},{"if":{"allOf":[{"properties":{"model":{"const":"hailuo-2.3-image-to-video-standard"}},"required":["model"]},{"properties":{"duration_seconds":{"const":10}},"required":["duration_seconds"]}]},"then":{"properties":{"output_resolution":{"enum":["768p"]}}}}]}]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/hailuo/image_to_video/{id}":{"get":{"tags":["Hailuo"],"summary":"Retrieve Hailuo Image-to-Video task","description":"Create an asynchronous task through the Hailuo image to video endpoint.","operationId":"task_endpoint_hailuo_image_to_video_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","videos","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"videos":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/hailuo/text_to_video":{"post":{"tags":["Hailuo"],"summary":"Hailuo Text-to-Video","description":"Create an asynchronous task through the Hailuo text to video endpoint.","operationId":"task_endpoint_hailuo_text_to_video","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"model":{"type":"string","const":"hailuo-02-text-to-video-pro"},"prompt":{"type":"string"},"duration_seconds":{"type":"integer"},"prompt_optimizer":{"type":"boolean"},"enable_safety_checker":{"type":"boolean"},"callback_url":{"type":"string"}},"additionalProperties":false,"required":["model"]},{"type":"object","properties":{"model":{"type":"string","const":"hailuo-02-text-to-video-standard"},"prompt":{"type":"string"},"duration_seconds":{"type":"integer","enum":[6,10],"default":6},"prompt_optimizer":{"type":"boolean"},"enable_safety_checker":{"type":"boolean"},"callback_url":{"type":"string"}},"additionalProperties":false,"required":["model"]}]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/hailuo/text_to_video/{id}":{"get":{"tags":["Hailuo"],"summary":"Retrieve Hailuo Text-to-Video task","description":"Create an asynchronous task through the Hailuo text to video endpoint.","operationId":"task_endpoint_hailuo_text_to_video_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","videos","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"videos":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/happyhorse/edit_video":{"post":{"tags":["HappyHorse"],"summary":"HappyHorse Edit-Video","description":"Create an asynchronous task through the HappyHorse edit video endpoint.","operationId":"task_endpoint_happyhorse_edit_video","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"model":{"type":"string","const":"happyhorse-edit-video"},"prompt":{"type":"string"},"source_video_url":{"type":"string"},"reference_image_urls":{"type":"array","maxItems":5},"output_resolution":{"type":"string","enum":["720p","1080p"],"default":"1080p"},"audio_setting":{"type":"string","enum":["auto","original"],"default":"auto"},"seed":{"type":"integer"},"callback_url":{"type":"string"}},"additionalProperties":false,"required":["source_video_url","model"]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/happyhorse/edit_video/{id}":{"get":{"tags":["HappyHorse"],"summary":"Retrieve HappyHorse Edit-Video task","description":"Create an asynchronous task through the HappyHorse edit video endpoint.","operationId":"task_endpoint_happyhorse_edit_video_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","videos","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"videos":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/happyhorse/image_to_video":{"post":{"tags":["HappyHorse"],"summary":"HappyHorse Image-to-Video","description":"Create an asynchronous task through the HappyHorse image to video endpoint.","operationId":"task_endpoint_happyhorse_image_to_video","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"model":{"type":"string","const":"happyhorse-1.0-i2v"},"first_frame_image_url":{"type":"string"},"prompt":{"type":"string"},"output_resolution":{"type":"string","enum":["720p","1080p"],"default":"1080p"},"duration_seconds":{"type":"integer","default":5},"seed":{"type":"integer"},"callback_url":{"type":"string"}},"additionalProperties":false,"required":["first_frame_image_url","model"]},{"type":"object","properties":{"model":{"type":"string","const":"happyhorse-image-to-video"},"first_frame_image_url":{"type":"string"},"prompt":{"type":"string"},"output_resolution":{"type":"string","enum":["720p","1080p"],"default":"1080p"},"duration_seconds":{"type":"integer","default":5},"seed":{"type":"integer"},"callback_url":{"type":"string"}},"additionalProperties":false,"required":["first_frame_image_url","model"]}]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/happyhorse/image_to_video/{id}":{"get":{"tags":["HappyHorse"],"summary":"Retrieve HappyHorse Image-to-Video task","description":"Create an asynchronous task through the HappyHorse image to video endpoint.","operationId":"task_endpoint_happyhorse_image_to_video_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","videos","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"videos":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/happyhorse/text_to_video":{"post":{"tags":["HappyHorse"],"summary":"HappyHorse Text-to-Video","description":"Create an asynchronous task through the HappyHorse text to video endpoint.","operationId":"task_endpoint_happyhorse_text_to_video","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"model":{"type":"string","const":"happyhorse-1.0-r2v"},"prompt":{"type":"string"},"reference_image_urls":{"type":"array","maxItems":9,"minItems":1},"output_resolution":{"type":"string","enum":["720p","1080p"],"default":"1080p"},"aspect_ratio":{"type":"string","enum":["16:9","9:16","1:1","4:3","3:4"],"default":"16:9"},"duration_seconds":{"type":"integer","default":5},"seed":{"type":"integer"},"callback_url":{"type":"string"}},"additionalProperties":false,"required":["reference_image_urls","model"]},{"type":"object","properties":{"model":{"type":"string","const":"happyhorse-1.0-t2v"},"prompt":{"type":"string"},"reference_image_urls":{"type":"array"},"output_resolution":{"type":"string","enum":["720p","1080p"],"default":"1080p"},"aspect_ratio":{"type":"string","enum":["16:9","9:16","1:1","4:3","3:4"],"default":"16:9"},"duration_seconds":{"type":"integer","default":5},"seed":{"type":"integer"},"callback_url":{"type":"string"}},"additionalProperties":false,"required":["model"]},{"type":"object","properties":{"model":{"type":"string","const":"happyhorse-character"},"prompt":{"type":"string"},"reference_image_urls":{"type":"array","maxItems":9,"minItems":1},"output_resolution":{"type":"string","enum":["720p","1080p"],"default":"1080p"},"aspect_ratio":{"type":"string","enum":["16:9","9:16","1:1","4:3","3:4"],"default":"16:9"},"duration_seconds":{"type":"integer","default":5},"seed":{"type":"integer"},"callback_url":{"type":"string"}},"additionalProperties":false,"required":["reference_image_urls","model"]},{"type":"object","properties":{"model":{"type":"string","const":"happyhorse-text-to-video"},"prompt":{"type":"string"},"reference_image_urls":{"type":"array"},"output_resolution":{"type":"string","enum":["720p","1080p"],"default":"1080p"},"aspect_ratio":{"type":"string","enum":["16:9","9:16","1:1","4:3","3:4"],"default":"16:9"},"duration_seconds":{"type":"integer","default":5},"seed":{"type":"integer"},"callback_url":{"type":"string"}},"additionalProperties":false,"required":["model"]}]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/happyhorse/text_to_video/{id}":{"get":{"tags":["HappyHorse"],"summary":"Retrieve HappyHorse Text-to-Video task","description":"Create an asynchronous task through the HappyHorse text to video endpoint.","operationId":"task_endpoint_happyhorse_text_to_video_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","videos","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"videos":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/heygen_video/image_to_video":{"post":{"tags":["HeyGen Video"],"summary":"HeyGen Video Image-to-Video","description":"Create an asynchronous task through the HeyGen Video image to video endpoint.","operationId":"task_endpoint_heygen_video_image_to_video","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"heygen-video-1"},"prompt":{"type":"string","maxLength":16000,"minLength":1,"description":"Video generation prompt describing the scene, dialogue, and sound."},"first_frame_image_url":{"type":"string","pattern":"^https://","description":"Public HTTPS first-frame image URL, up to 16 MB; the video follows the image's aspect ratio."},"duration_seconds":{"type":"integer","enum":[5,6,7,8,9,10,11,12,13,14,15],"default":5,"description":"Generated video duration in seconds."},"output_resolution":{"type":"string","enum":["480p","768p","1080p","2k"],"default":"768p","description":"Generated video resolution."},"seed":{"type":"integer","maximum":4294967295,"minimum":0,"description":"Random seed for reproducible generation."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."}},"additionalProperties":false,"required":["model","prompt","first_frame_image_url"]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/heygen_video/image_to_video/{id}":{"get":{"tags":["HeyGen Video"],"summary":"Retrieve HeyGen Video Image-to-Video task","description":"Create an asynchronous task through the HeyGen Video image to video endpoint.","operationId":"task_endpoint_heygen_video_image_to_video_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","videos","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"videos":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/heygen_video/text_to_video":{"post":{"tags":["HeyGen Video"],"summary":"HeyGen Video Text-to-Video","description":"Create an asynchronous task through the HeyGen Video text to video endpoint.","operationId":"task_endpoint_heygen_video_text_to_video","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"heygen-video-1"},"prompt":{"type":"string","maxLength":16000,"minLength":1,"description":"Video generation prompt describing the scene, dialogue, and sound."},"duration_seconds":{"type":"integer","enum":[5,6,7,8,9,10,11,12,13,14,15],"default":5,"description":"Generated video duration in seconds."},"output_resolution":{"type":"string","enum":["480p","768p","1080p","2k"],"default":"768p","description":"Generated video resolution; 1080p and 2k support only 16:9 and 9:16."},"aspect_ratio":{"type":"string","enum":["adaptive","21:9","16:9","4:3","1:1","3:4","9:16"],"description":"Generated video aspect ratio; adaptive follows the first reference image or video and is available only with reference media at 480p or 768p."},"reference_image_urls":{"type":"array","items":{"type":"string","pattern":"^https://"},"maxItems":9,"description":"Public HTTPS reference image URLs, up to 16 MB each; up to 12 reference files in total across images, videos, and audio."},"reference_video_urls":{"type":"array","items":{"type":"string","pattern":"^https://"},"maxItems":3,"description":"Public HTTPS reference video URLs with aspect ratio between 1:4 and 4:1, up to 32 MB each; only the first 5 seconds of each video are used."},"reference_audio_urls":{"type":"array","items":{"type":"string","pattern":"^https://"},"maxItems":3,"description":"Public HTTPS reference audio URLs, up to 32 MB each; requires reference images or videos."},"seed":{"type":"integer","maximum":4294967295,"minimum":0,"description":"Random seed for reproducible generation."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."}},"additionalProperties":false,"required":["model","prompt"],"allOf":[{"if":{"required":["reference_audio_urls"]},"then":{"anyOf":[{"required":["reference_image_urls"]},{"required":["reference_video_urls"]}]}},{"if":{"allOf":[{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_urls"]}}]},"then":{"properties":{"aspect_ratio":{"enum":["21:9","16:9","4:3","1:1","3:4","9:16"]}}}},{"if":{"properties":{"output_resolution":{"const":"1080p"}},"required":["output_resolution"]},"then":{"properties":{"aspect_ratio":{"enum":["16:9","9:16"]}}}},{"if":{"properties":{"output_resolution":{"const":"2k"}},"required":["output_resolution"]},"then":{"properties":{"aspect_ratio":{"enum":["16:9","9:16"]}}}}]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/heygen_video/text_to_video/{id}":{"get":{"tags":["HeyGen Video"],"summary":"Retrieve HeyGen Video Text-to-Video task","description":"Create an asynchronous task through the HeyGen Video text to video endpoint.","operationId":"task_endpoint_heygen_video_text_to_video_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","videos","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"videos":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/ideogram_v3/edit_image":{"post":{"tags":["Ideogram V3"],"summary":"Ideogram V3 Edit-Image","description":"Create an asynchronous task through the Ideogram V3 edit image endpoint.","operationId":"task_endpoint_ideogram_v3_edit_image","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"model":{"type":"string","const":"ideogram-v3-character-edit"},"prompt":{"type":"string"},"source_image_url":{"type":"string"},"mask_url":{"type":"string"},"rendering_speed":{"type":"string","enum":["turbo","balanced","quality"],"default":"balanced"},"style":{"type":"string","enum":["auto","realistic","fiction"]},"enable_prompt_expansion":{"type":"boolean"},"output_count":{"type":"integer","enum":[1,2,3,4],"default":1},"seed":{"type":"integer"},"reference_image_urls":{"type":"array"},"callback_url":{"type":"string"}},"additionalProperties":false,"required":["source_image_url","mask_url","reference_image_urls","model"]},{"type":"object","properties":{"model":{"type":"string","const":"ideogram-v3-edit"},"prompt":{"type":"string"},"source_image_url":{"type":"string"},"mask_url":{"type":"string"},"rendering_speed":{"type":"string","enum":["turbo","balanced","quality"],"default":"balanced"},"style":{"type":"string"},"enable_prompt_expansion":{"type":"boolean"},"output_count":{"type":"integer","enum":[1,2,3,4],"default":1},"seed":{"type":"integer"},"reference_image_urls":{"type":"array"},"callback_url":{"type":"string"}},"additionalProperties":false,"required":["source_image_url","mask_url","model"]}]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/ideogram_v3/edit_image/{id}":{"get":{"tags":["Ideogram V3"],"summary":"Retrieve Ideogram V3 Edit-Image task","description":"Create an asynchronous task through the Ideogram V3 edit image endpoint.","operationId":"task_endpoint_ideogram_v3_edit_image_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","images","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"images":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/ideogram_v3/reframe_image/{id}":{"get":{"tags":["Ideogram V3"],"summary":"Retrieve Ideogram V3 Reframe-Image task","description":"This endpoint is retired. New requests return HTTP 410. Existing tasks remain queryable.","operationId":"task_endpoint_ideogram_v3_reframe_image_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","images","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"images":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/ideogram_v3/remix_image":{"post":{"tags":["Ideogram V3"],"summary":"Ideogram V3 Remix-Image","description":"Create an asynchronous task through the Ideogram V3 remix image endpoint.","operationId":"task_endpoint_ideogram_v3_remix_image","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"model":{"type":"string","const":"ideogram-v3-character-remix"},"prompt":{"type":"string"},"source_image_url":{"type":"string"},"rendering_speed":{"type":"string","enum":["turbo","balanced","quality"],"default":"balanced"},"style":{"type":"string","enum":["auto","realistic","fiction"]},"enable_prompt_expansion":{"type":"boolean"},"aspect_ratio":{"type":"string","enum":["1:1","3:4","9:16","4:3","16:9"]},"output_count":{"type":"integer","enum":[1,2,3,4],"default":1},"seed":{"type":"integer"},"strength":{"type":"number"},"negative_prompt":{"type":"string"},"reference_image_urls":{"type":"array"},"style_reference_image_urls":{"type":"array"},"reference_mask_urls":{"type":"array"},"callback_url":{"type":"string"}},"additionalProperties":false,"required":["source_image_url","reference_image_urls","model"]},{"type":"object","properties":{"model":{"type":"string","const":"ideogram-v3-remix"},"prompt":{"type":"string"},"source_image_url":{"type":"string"},"rendering_speed":{"type":"string","enum":["turbo","balanced","quality"],"default":"balanced"},"style":{"type":"string","enum":["auto","general","realistic","design"]},"enable_prompt_expansion":{"type":"boolean"},"aspect_ratio":{"type":"string","enum":["1:1","3:4","9:16","4:3","16:9"]},"output_count":{"type":"integer","enum":[1,2,3,4],"default":1},"seed":{"type":"integer"},"strength":{"type":"number"},"negative_prompt":{"type":"string"},"reference_image_urls":{"type":"array"},"style_reference_image_urls":{"type":"array"},"reference_mask_urls":{"type":"array"},"callback_url":{"type":"string"}},"additionalProperties":false,"required":["source_image_url","model"]}]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/ideogram_v3/remix_image/{id}":{"get":{"tags":["Ideogram V3"],"summary":"Retrieve Ideogram V3 Remix-Image task","description":"Create an asynchronous task through the Ideogram V3 remix image endpoint.","operationId":"task_endpoint_ideogram_v3_remix_image_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","images","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"images":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/ideogram_v3/text_to_image":{"post":{"tags":["Ideogram V3"],"summary":"Ideogram V3 Text-to-Image","description":"Create an asynchronous task through the Ideogram V3 text to image endpoint.","operationId":"task_endpoint_ideogram_v3_text_to_image","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"model":{"type":"string","const":"ideogram-v3-character"},"prompt":{"type":"string"},"rendering_speed":{"type":"string","enum":["turbo","balanced","quality"],"default":"balanced"},"style":{"type":"string","enum":["auto","realistic","fiction"]},"enable_prompt_expansion":{"type":"boolean"},"aspect_ratio":{"type":"string","enum":["1:1","3:4","9:16","4:3","16:9"]},"output_count":{"type":"integer","enum":[1,2,3,4],"default":1},"seed":{"type":"integer"},"negative_prompt":{"type":"string"},"reference_image_urls":{"type":"array"},"callback_url":{"type":"string"}},"additionalProperties":false,"required":["reference_image_urls","model"]},{"type":"object","properties":{"model":{"type":"string","const":"ideogram-v3-text-to-image"},"prompt":{"type":"string"},"rendering_speed":{"type":"string","enum":["turbo","balanced","quality"],"default":"balanced"},"style":{"type":"string","enum":["auto","general","realistic","design"]},"enable_prompt_expansion":{"type":"boolean"},"aspect_ratio":{"type":"string","enum":["1:1","3:4","9:16","4:3","16:9"]},"output_count":{"type":"integer","enum":[1,2,3,4],"default":1},"seed":{"type":"integer"},"negative_prompt":{"type":"string"},"reference_image_urls":{"type":"array"},"callback_url":{"type":"string"}},"additionalProperties":false,"required":["model"]}]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/ideogram_v3/text_to_image/{id}":{"get":{"tags":["Ideogram V3"],"summary":"Retrieve Ideogram V3 Text-to-Image task","description":"Create an asynchronous task through the Ideogram V3 text to image endpoint.","operationId":"task_endpoint_ideogram_v3_text_to_image_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","images","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"images":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/imagen_4/remix_image":{"post":{"tags":["Imagen 4"],"summary":"Imagen 4 Remix-Image","description":"Create an asynchronous task through the Imagen 4 remix image endpoint.","operationId":"task_endpoint_imagen_4_remix_image","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"model":{"type":"string","const":"imagen-4-pro-remix-image"},"prompt":{"type":"string"},"source_image_urls":{"type":"array","maxItems":8,"minItems":1},"callback_url":{"type":"string"},"aspect_ratio":{"type":"string","enum":["1:1","2:3","3:2","3:4","4:3","4:5","5:4","9:16","16:9","21:9","auto"]},"output_resolution":{"type":"string","enum":["1k","2k","4k"],"default":"1k"},"output_format":{"type":"string","enum":["png","jpg"]}},"additionalProperties":false,"required":["source_image_urls","model"]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"422":{"description":"Provider invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"500":{"description":"Request failed","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/imagen_4/remix_image/{id}":{"get":{"tags":["Imagen 4"],"summary":"Retrieve Imagen 4 Remix-Image task","description":"Create an asynchronous task through the Imagen 4 remix image endpoint.","operationId":"task_endpoint_imagen_4_remix_image_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","images","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"images":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/imagen_4/text_to_image":{"post":{"tags":["Imagen 4"],"summary":"Imagen 4 Text-to-Image","description":"Create an asynchronous task through the Imagen 4 text to image endpoint.","operationId":"task_endpoint_imagen_4_text_to_image","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"model":{"type":"string","const":"imagen-4"},"prompt":{"type":"string"},"callback_url":{"type":"string"},"negative_prompt":{"type":"string"},"aspect_ratio":{"type":"string","enum":["1:1","16:9","9:16","3:4","4:3"]},"seed":{"type":"integer"}},"additionalProperties":false,"required":["model"]},{"type":"object","properties":{"model":{"type":"string","const":"imagen-4-fast"},"prompt":{"type":"string"},"callback_url":{"type":"string"},"negative_prompt":{"type":"string"},"aspect_ratio":{"type":"string","enum":["1:1","16:9","9:16","3:4","4:3","auto"]},"seed":{"type":"integer"}},"additionalProperties":false,"required":["model"]},{"type":"object","properties":{"model":{"type":"string","const":"imagen-4-ultra"},"prompt":{"type":"string"},"callback_url":{"type":"string"},"negative_prompt":{"type":"string"},"aspect_ratio":{"type":"string","enum":["1:1","16:9","9:16","3:4","4:3"]},"seed":{"type":"integer"}},"additionalProperties":false,"required":["model"]}]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"422":{"description":"Provider invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"500":{"description":"Request failed","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/imagen_4/text_to_image/{id}":{"get":{"tags":["Imagen 4"],"summary":"Retrieve Imagen 4 Text-to-Image task","description":"Create an asynchronous task through the Imagen 4 text to image endpoint.","operationId":"task_endpoint_imagen_4_text_to_image_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","images","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"images":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/infinitetalk/audio_to_video":{"post":{"tags":["InfiniteTalk"],"summary":"InfiniteTalk Audio-to-Video","description":"Create an asynchronous task through the InfiniteTalk audio to video endpoint.","operationId":"task_endpoint_infinitetalk_audio_to_video","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"model":{"type":"string","const":"infinitetalk-from-audio"},"source_image_url":{"type":"string"},"source_audio_url":{"type":"string"},"prompt":{"type":"string"},"callback_url":{"type":"string"},"output_resolution":{"type":"string","enum":["480p","720p"],"default":"480p"},"seed":{"type":"integer"}},"additionalProperties":false,"required":["source_image_url","source_audio_url","model"]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/infinitetalk/audio_to_video/{id}":{"get":{"tags":["InfiniteTalk"],"summary":"Retrieve InfiniteTalk Audio-to-Video task","description":"Create an asynchronous task through the InfiniteTalk audio to video endpoint.","operationId":"task_endpoint_infinitetalk_audio_to_video_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","videos","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"videos":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/kling/ai_avatar":{"post":{"tags":["Kling"],"summary":"Kling Avatar","description":"Create an asynchronous task through the Kling avatar endpoint.","operationId":"task_endpoint_kling_avatar","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"kling-ai-avatar-pro"},"source_image_url":{"type":"string","description":"Face image URL."},"source_audio_url":{"type":"string","description":"Audio URL for lip sync."},"prompt":{"type":"string","description":"Description of the avatar."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."}},"additionalProperties":false,"required":["model","source_image_url","source_audio_url","prompt"]},{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"kling-ai-avatar-standard"},"source_image_url":{"type":"string","description":"Face image URL."},"source_audio_url":{"type":"string","description":"Audio URL for lip sync."},"prompt":{"type":"string","description":"Description of the avatar."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."}},"additionalProperties":false,"required":["model","source_image_url","source_audio_url","prompt"]}]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/kling/ai_avatar/{id}":{"get":{"tags":["Kling"],"summary":"Retrieve Kling Avatar task","description":"Create an asynchronous task through the Kling avatar endpoint.","operationId":"task_endpoint_kling_avatar_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","videos","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"videos":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/kling/edit_video":{"post":{"tags":["Kling"],"summary":"Kling Edit-Video","description":"Create an asynchronous task through the Kling edit video endpoint.","operationId":"task_endpoint_kling_edit_video","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"kling-v3-omni-edit"},"prompt":{"type":"string","maxLength":2500,"minLength":1,"description":"Video description."},"source_video_url":{"type":"string","description":"Public source video URL; cannot be combined with source_task_id."},"source_task_id":{"type":"string","description":"Completed compatible task ID; cannot be combined with source_video_url."},"reference_image_urls":{"type":"array","items":{"type":"string"},"maxItems":4,"minItems":1,"description":"Ordered reference image URLs."},"duration_seconds":{"type":"integer","enum":[3,4,5,6,7,8,9,10,11,12,13,14,15],"default":5,"description":"Output duration in seconds."},"output_resolution":{"type":"string","enum":["720p","1080p","4k"],"default":"720p","description":"Output resolution."},"aspect_ratio":{"type":"string","enum":["auto","16:9","9:16","1:1"],"description":"Output aspect ratio; source-only requests require auto."},"enable_sound":{"type":"boolean","default":false,"description":"Enable synchronized sound generation."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."}},"additionalProperties":false,"required":["model","prompt"],"allOf":[{"if":{"allOf":[{"properties":{"model":{"const":"kling-v3-omni-edit"}},"required":["model"]},{"not":{"required":["source_task_id"]}},{"not":{"required":["source_video_url"]}}]},"then":{"anyOf":[{"required":["source_video_url"]},{"required":["source_task_id"]}]}},{"if":{"allOf":[{"properties":{"model":{"const":"kling-v3-omni-edit"}},"required":["model"]},{"required":["source_video_url"]}]},"then":{"not":{"required":["source_task_id"]}}},{"if":{"allOf":[{"properties":{"model":{"const":"kling-v3-omni-edit"}},"required":["model"]},{"required":["source_task_id"]}]},"then":{"not":{"required":["source_video_url"]}}},{"if":{"allOf":[{"properties":{"model":{"const":"kling-v3-omni-edit"}},"required":["model"]},{"required":["source_video_url"]},{"not":{"required":["reference_image_urls"]}}]},"then":{"allOf":[{"required":["aspect_ratio"]},{"properties":{"aspect_ratio":{"enum":["auto"]},"duration_seconds":{"enum":[5]}}}]}},{"if":{"allOf":[{"properties":{"model":{"const":"kling-v3-omni-edit"}},"required":["model"]},{"required":["source_task_id"]},{"not":{"required":["reference_image_urls"]}}]},"then":{"allOf":[{"required":["aspect_ratio"]},{"properties":{"aspect_ratio":{"enum":["auto"]},"duration_seconds":{"enum":[5]}}}]}},{"if":{"allOf":[{"properties":{"model":{"const":"kling-v3-omni-edit"}},"required":["model"]},{"required":["source_video_url"]},{"required":["reference_image_urls"]}]},"then":{"allOf":[{"required":["aspect_ratio"]},{"properties":{"aspect_ratio":{"enum":["16:9","9:16","1:1"]}}}]}},{"if":{"allOf":[{"properties":{"model":{"const":"kling-v3-omni-edit"}},"required":["model"]},{"required":["source_task_id"]},{"required":["reference_image_urls"]}]},"then":{"allOf":[{"required":["aspect_ratio"]},{"properties":{"aspect_ratio":{"enum":["16:9","9:16","1:1"]}}}]}},{"if":{"allOf":[{"properties":{"model":{"const":"kling-v3-omni-reference"}},"required":["model"]},{"not":{"required":["source_task_id"]}},{"not":{"required":["source_video_url"]}}]},"then":{"anyOf":[{"required":["source_video_url"]},{"required":["source_task_id"]}]}},{"if":{"allOf":[{"properties":{"model":{"const":"kling-v3-omni-reference"}},"required":["model"]},{"required":["source_video_url"]}]},"then":{"not":{"required":["source_task_id"]}}},{"if":{"allOf":[{"properties":{"model":{"const":"kling-v3-omni-reference"}},"required":["model"]},{"required":["source_task_id"]}]},"then":{"not":{"required":["source_video_url"]}}},{"if":{"allOf":[{"properties":{"model":{"const":"kling-v3-omni-reference"}},"required":["model"]},{"required":["source_video_url"]},{"not":{"required":["reference_image_urls"]}}]},"then":{"allOf":[{"required":["aspect_ratio"]},{"properties":{"aspect_ratio":{"enum":["auto"]},"enable_sound":{"enum":[false]},"duration_seconds":{"enum":[5]}}}]}},{"if":{"allOf":[{"properties":{"model":{"const":"kling-v3-omni-reference"}},"required":["model"]},{"required":["source_task_id"]},{"not":{"required":["reference_image_urls"]}}]},"then":{"allOf":[{"required":["aspect_ratio"]},{"properties":{"aspect_ratio":{"enum":["auto"]},"enable_sound":{"enum":[false]},"duration_seconds":{"enum":[5]}}}]}},{"if":{"allOf":[{"properties":{"model":{"const":"kling-v3-omni-reference"}},"required":["model"]},{"required":["source_video_url"]},{"required":["reference_image_urls"]}]},"then":{"allOf":[{"required":["aspect_ratio"]},{"properties":{"aspect_ratio":{"enum":["16:9","9:16","1:1"]},"enable_sound":{"enum":[false]}}}]}},{"if":{"allOf":[{"properties":{"model":{"const":"kling-v3-omni-reference"}},"required":["model"]},{"required":["source_task_id"]},{"required":["reference_image_urls"]}]},"then":{"allOf":[{"required":["aspect_ratio"]},{"properties":{"aspect_ratio":{"enum":["16:9","9:16","1:1"]},"enable_sound":{"enum":[false]}}}]}}]},{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"kling-v3-omni-reference"},"prompt":{"type":"string","maxLength":2500,"minLength":1,"description":"Video description."},"source_video_url":{"type":"string","description":"Public source video URL; cannot be combined with source_task_id."},"source_task_id":{"type":"string","description":"Completed compatible task ID; cannot be combined with source_video_url."},"reference_image_urls":{"type":"array","items":{"type":"string"},"maxItems":4,"minItems":1,"description":"Ordered reference image URLs."},"duration_seconds":{"type":"integer","enum":[3,4,5,6,7,8,9,10,11,12,13,14,15],"default":5,"description":"Output duration in seconds."},"output_resolution":{"type":"string","enum":["720p","1080p","4k"],"default":"720p","description":"Output resolution."},"aspect_ratio":{"type":"string","enum":["auto","16:9","9:16","1:1"],"description":"Output aspect ratio; source-only requests require auto."},"enable_sound":{"type":"boolean","default":false,"description":"Enable synchronized sound generation; source-video requests require false."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."}},"additionalProperties":false,"required":["model","prompt"],"allOf":[{"if":{"allOf":[{"properties":{"model":{"const":"kling-v3-omni-edit"}},"required":["model"]},{"not":{"required":["source_task_id"]}},{"not":{"required":["source_video_url"]}}]},"then":{"anyOf":[{"required":["source_video_url"]},{"required":["source_task_id"]}]}},{"if":{"allOf":[{"properties":{"model":{"const":"kling-v3-omni-edit"}},"required":["model"]},{"required":["source_video_url"]}]},"then":{"not":{"required":["source_task_id"]}}},{"if":{"allOf":[{"properties":{"model":{"const":"kling-v3-omni-edit"}},"required":["model"]},{"required":["source_task_id"]}]},"then":{"not":{"required":["source_video_url"]}}},{"if":{"allOf":[{"properties":{"model":{"const":"kling-v3-omni-edit"}},"required":["model"]},{"required":["source_video_url"]},{"not":{"required":["reference_image_urls"]}}]},"then":{"allOf":[{"required":["aspect_ratio"]},{"properties":{"aspect_ratio":{"enum":["auto"]},"duration_seconds":{"enum":[5]}}}]}},{"if":{"allOf":[{"properties":{"model":{"const":"kling-v3-omni-edit"}},"required":["model"]},{"required":["source_task_id"]},{"not":{"required":["reference_image_urls"]}}]},"then":{"allOf":[{"required":["aspect_ratio"]},{"properties":{"aspect_ratio":{"enum":["auto"]},"duration_seconds":{"enum":[5]}}}]}},{"if":{"allOf":[{"properties":{"model":{"const":"kling-v3-omni-edit"}},"required":["model"]},{"required":["source_video_url"]},{"required":["reference_image_urls"]}]},"then":{"allOf":[{"required":["aspect_ratio"]},{"properties":{"aspect_ratio":{"enum":["16:9","9:16","1:1"]}}}]}},{"if":{"allOf":[{"properties":{"model":{"const":"kling-v3-omni-edit"}},"required":["model"]},{"required":["source_task_id"]},{"required":["reference_image_urls"]}]},"then":{"allOf":[{"required":["aspect_ratio"]},{"properties":{"aspect_ratio":{"enum":["16:9","9:16","1:1"]}}}]}},{"if":{"allOf":[{"properties":{"model":{"const":"kling-v3-omni-reference"}},"required":["model"]},{"not":{"required":["source_task_id"]}},{"not":{"required":["source_video_url"]}}]},"then":{"anyOf":[{"required":["source_video_url"]},{"required":["source_task_id"]}]}},{"if":{"allOf":[{"properties":{"model":{"const":"kling-v3-omni-reference"}},"required":["model"]},{"required":["source_video_url"]}]},"then":{"not":{"required":["source_task_id"]}}},{"if":{"allOf":[{"properties":{"model":{"const":"kling-v3-omni-reference"}},"required":["model"]},{"required":["source_task_id"]}]},"then":{"not":{"required":["source_video_url"]}}},{"if":{"allOf":[{"properties":{"model":{"const":"kling-v3-omni-reference"}},"required":["model"]},{"required":["source_video_url"]},{"not":{"required":["reference_image_urls"]}}]},"then":{"allOf":[{"required":["aspect_ratio"]},{"properties":{"aspect_ratio":{"enum":["auto"]},"enable_sound":{"enum":[false]},"duration_seconds":{"enum":[5]}}}]}},{"if":{"allOf":[{"properties":{"model":{"const":"kling-v3-omni-reference"}},"required":["model"]},{"required":["source_task_id"]},{"not":{"required":["reference_image_urls"]}}]},"then":{"allOf":[{"required":["aspect_ratio"]},{"properties":{"aspect_ratio":{"enum":["auto"]},"enable_sound":{"enum":[false]},"duration_seconds":{"enum":[5]}}}]}},{"if":{"allOf":[{"properties":{"model":{"const":"kling-v3-omni-reference"}},"required":["model"]},{"required":["source_video_url"]},{"required":["reference_image_urls"]}]},"then":{"allOf":[{"required":["aspect_ratio"]},{"properties":{"aspect_ratio":{"enum":["16:9","9:16","1:1"]},"enable_sound":{"enum":[false]}}}]}},{"if":{"allOf":[{"properties":{"model":{"const":"kling-v3-omni-reference"}},"required":["model"]},{"required":["source_task_id"]},{"required":["reference_image_urls"]}]},"then":{"allOf":[{"required":["aspect_ratio"]},{"properties":{"aspect_ratio":{"enum":["16:9","9:16","1:1"]},"enable_sound":{"enum":[false]}}}]}}]}]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/kling/edit_video/{id}":{"get":{"tags":["Kling"],"summary":"Retrieve Kling Edit-Video task","description":"Create an asynchronous task through the Kling edit video endpoint.","operationId":"task_endpoint_kling_edit_video_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","videos","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"videos":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/kling/extend_video":{"post":{"tags":["Kling"],"summary":"Kling Extend-Video","description":"Create an asynchronous task through the Kling extend video endpoint.","operationId":"task_endpoint_kling_extend_video","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"source_task_id":{"type":"string","description":"Completed Kling v2.5 Turbo source task ID."},"mode":{"type":"string","enum":["std","pro"],"default":"std","description":"Extension quality mode."},"prompt":{"type":"string","description":"Optional description for the continuation."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."},"model":{"type":"string","const":"kling-v2.5-turbo-image-to-video-pro"}},"additionalProperties":false,"required":["source_task_id","model"]},{"type":"object","properties":{"source_task_id":{"type":"string","description":"Completed Kling v2.5 Turbo source task ID."},"mode":{"type":"string","enum":["std","pro"],"default":"std","description":"Extension quality mode."},"prompt":{"type":"string","description":"Optional description for the continuation."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."},"model":{"type":"string","const":"kling-v2.5-turbo-text-to-video-pro"}},"additionalProperties":false,"required":["source_task_id","model"]}]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/kling/extend_video/{id}":{"get":{"tags":["Kling"],"summary":"Retrieve Kling Extend-Video task","description":"Create an asynchronous task through the Kling extend video endpoint.","operationId":"task_endpoint_kling_extend_video_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","videos","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"videos":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/kling/image_to_video":{"post":{"tags":["Kling"],"summary":"Kling Image-to-Video","description":"Create an asynchronous task through the Kling image to video endpoint.","operationId":"task_endpoint_kling_image_to_video","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"kling-o1"},"prompt":{"type":"string","maxLength":2500,"minLength":1,"description":"Video description; reference media with matching numbered markers."},"first_frame_image_url":{"type":"string","description":"Public HTTP(S) JPG, JPEG, or PNG first-frame image URL."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."},"mode":{"type":"string","enum":["std","pro"],"default":"std","description":"Generation mode."},"enable_sound":{"type":"boolean","default":false,"description":"Sound generation must remain disabled."},"duration_seconds":{"type":"integer","enum":[5],"default":5,"description":"Duration in seconds."},"aspect_ratio":{"type":"string","enum":["16:9","9:16","1:1"],"default":"16:9","description":"Output aspect ratio."},"last_frame_image_url":{"type":"string","description":"Public HTTP(S) JPG, JPEG, or PNG final-frame image URL; cannot be combined with reference_image_urls or reference_video_url."},"reference_image_urls":{"type":"array","items":{"type":"string"},"maxItems":7,"minItems":1,"description":"Ordered public HTTP(S) JPG, JPEG, or PNG reference image URLs; cannot be combined with last_frame_image_url."},"reference_video_url":{"type":"string","description":"Public HTTP(S) MP4 or MOV reference video URL; cannot be combined with last_frame_image_url."},"reference_video_type":{"type":"string","enum":["base","feature"],"default":"base","description":"Use the video as a base edit or feature reference."},"preserve_reference_video_audio":{"type":"boolean","default":false,"description":"Preserve the reference video's original audio."}},"additionalProperties":false,"required":["model","prompt","first_frame_image_url"],"allOf":[{"if":{"properties":{"model":{"const":"kling-o1"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["negative_prompt"]}},{"not":{"required":["cfg_scale"]}}]}},{"if":{"properties":{"model":{"const":"kling-v2.1-master-image-to-video"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["enable_sound"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"properties":{"model":{"const":"kling-v2.1-pro"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["enable_sound"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"properties":{"model":{"const":"kling-v2.1-standard"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["enable_sound"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"properties":{"model":{"const":"kling-v2.5-turbo-image-to-video-pro"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["enable_sound"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"properties":{"model":{"const":"kling-v2.6"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["negative_prompt"]}},{"not":{"required":["cfg_scale"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"allOf":[{"properties":{"mode":{"const":"std"}},"required":["mode"]},{"properties":{"model":{"const":"kling-v2.6"}},"required":["model"]}]},"then":{"properties":{"enable_sound":{"enum":[false]}}}},{"if":{"allOf":[{"not":{"required":["mode"]}},{"properties":{"model":{"const":"kling-v2.6"}},"required":["model"]}]},"then":{"properties":{"enable_sound":{"enum":[false]}}}},{"if":{"properties":{"model":{"const":"kling-v3-omni"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["negative_prompt"]}},{"not":{"required":["cfg_scale"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"properties":{"model":{"const":"kling-v3-turbo-image-to-video"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["enable_sound"]}},{"not":{"required":["aspect_ratio"]}},{"not":{"required":["negative_prompt"]}},{"not":{"required":["cfg_scale"]}},{"not":{"required":["last_frame_image_url"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}}]},{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"kling-v2.1-master-image-to-video"},"prompt":{"type":"string","description":"Video description."},"first_frame_image_url":{"type":"string","description":"First frame image URL."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."},"duration_seconds":{"type":"integer","enum":[5,10],"default":5,"description":"Duration in seconds."},"aspect_ratio":{"type":"string","description":"Output aspect ratio."},"negative_prompt":{"type":"string","description":"Negative prompt."},"cfg_scale":{"type":"number","description":"Guidance scale (0-1)."},"last_frame_image_url":{"type":"string","description":"Final frame image URL for supported image-to-video models."}},"additionalProperties":false,"required":["model","prompt","first_frame_image_url"],"allOf":[{"if":{"properties":{"model":{"const":"kling-o1"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["negative_prompt"]}},{"not":{"required":["cfg_scale"]}}]}},{"if":{"properties":{"model":{"const":"kling-v2.1-master-image-to-video"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["enable_sound"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"properties":{"model":{"const":"kling-v2.1-pro"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["enable_sound"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"properties":{"model":{"const":"kling-v2.1-standard"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["enable_sound"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"properties":{"model":{"const":"kling-v2.5-turbo-image-to-video-pro"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["enable_sound"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"properties":{"model":{"const":"kling-v2.6"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["negative_prompt"]}},{"not":{"required":["cfg_scale"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"allOf":[{"properties":{"mode":{"const":"std"}},"required":["mode"]},{"properties":{"model":{"const":"kling-v2.6"}},"required":["model"]}]},"then":{"properties":{"enable_sound":{"enum":[false]}}}},{"if":{"allOf":[{"not":{"required":["mode"]}},{"properties":{"model":{"const":"kling-v2.6"}},"required":["model"]}]},"then":{"properties":{"enable_sound":{"enum":[false]}}}},{"if":{"properties":{"model":{"const":"kling-v3-omni"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["negative_prompt"]}},{"not":{"required":["cfg_scale"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"properties":{"model":{"const":"kling-v3-turbo-image-to-video"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["enable_sound"]}},{"not":{"required":["aspect_ratio"]}},{"not":{"required":["negative_prompt"]}},{"not":{"required":["cfg_scale"]}},{"not":{"required":["last_frame_image_url"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}}]},{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"kling-v2.1-pro"},"prompt":{"type":"string","description":"Video description."},"first_frame_image_url":{"type":"string","description":"First frame image URL."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."},"duration_seconds":{"type":"integer","enum":[5,10],"default":5,"description":"Duration in seconds."},"aspect_ratio":{"type":"string","description":"Output aspect ratio."},"negative_prompt":{"type":"string","description":"Negative prompt."},"cfg_scale":{"type":"number","description":"Guidance scale (0-1)."},"last_frame_image_url":{"type":"string","description":"Final frame image URL for supported image-to-video models."}},"additionalProperties":false,"required":["model","prompt","first_frame_image_url"],"allOf":[{"if":{"properties":{"model":{"const":"kling-o1"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["negative_prompt"]}},{"not":{"required":["cfg_scale"]}}]}},{"if":{"properties":{"model":{"const":"kling-v2.1-master-image-to-video"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["enable_sound"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"properties":{"model":{"const":"kling-v2.1-pro"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["enable_sound"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"properties":{"model":{"const":"kling-v2.1-standard"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["enable_sound"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"properties":{"model":{"const":"kling-v2.5-turbo-image-to-video-pro"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["enable_sound"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"properties":{"model":{"const":"kling-v2.6"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["negative_prompt"]}},{"not":{"required":["cfg_scale"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"allOf":[{"properties":{"mode":{"const":"std"}},"required":["mode"]},{"properties":{"model":{"const":"kling-v2.6"}},"required":["model"]}]},"then":{"properties":{"enable_sound":{"enum":[false]}}}},{"if":{"allOf":[{"not":{"required":["mode"]}},{"properties":{"model":{"const":"kling-v2.6"}},"required":["model"]}]},"then":{"properties":{"enable_sound":{"enum":[false]}}}},{"if":{"properties":{"model":{"const":"kling-v3-omni"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["negative_prompt"]}},{"not":{"required":["cfg_scale"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"properties":{"model":{"const":"kling-v3-turbo-image-to-video"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["enable_sound"]}},{"not":{"required":["aspect_ratio"]}},{"not":{"required":["negative_prompt"]}},{"not":{"required":["cfg_scale"]}},{"not":{"required":["last_frame_image_url"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}}]},{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"kling-v2.1-standard"},"prompt":{"type":"string","description":"Video description."},"first_frame_image_url":{"type":"string","description":"First frame image URL."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."},"duration_seconds":{"type":"integer","enum":[5,10],"default":5,"description":"Duration in seconds."},"aspect_ratio":{"type":"string","description":"Output aspect ratio."},"negative_prompt":{"type":"string","description":"Negative prompt."},"cfg_scale":{"type":"number","description":"Guidance scale (0-1)."},"last_frame_image_url":{"type":"string","description":"Final frame image URL for supported image-to-video models."}},"additionalProperties":false,"required":["model","prompt","first_frame_image_url"],"allOf":[{"if":{"properties":{"model":{"const":"kling-o1"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["negative_prompt"]}},{"not":{"required":["cfg_scale"]}}]}},{"if":{"properties":{"model":{"const":"kling-v2.1-master-image-to-video"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["enable_sound"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"properties":{"model":{"const":"kling-v2.1-pro"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["enable_sound"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"properties":{"model":{"const":"kling-v2.1-standard"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["enable_sound"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"properties":{"model":{"const":"kling-v2.5-turbo-image-to-video-pro"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["enable_sound"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"properties":{"model":{"const":"kling-v2.6"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["negative_prompt"]}},{"not":{"required":["cfg_scale"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"allOf":[{"properties":{"mode":{"const":"std"}},"required":["mode"]},{"properties":{"model":{"const":"kling-v2.6"}},"required":["model"]}]},"then":{"properties":{"enable_sound":{"enum":[false]}}}},{"if":{"allOf":[{"not":{"required":["mode"]}},{"properties":{"model":{"const":"kling-v2.6"}},"required":["model"]}]},"then":{"properties":{"enable_sound":{"enum":[false]}}}},{"if":{"properties":{"model":{"const":"kling-v3-omni"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["negative_prompt"]}},{"not":{"required":["cfg_scale"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"properties":{"model":{"const":"kling-v3-turbo-image-to-video"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["enable_sound"]}},{"not":{"required":["aspect_ratio"]}},{"not":{"required":["negative_prompt"]}},{"not":{"required":["cfg_scale"]}},{"not":{"required":["last_frame_image_url"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}}]},{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"kling-v2.5-turbo-image-to-video-pro"},"prompt":{"type":"string","description":"Video description."},"first_frame_image_url":{"type":"string","description":"First frame image URL."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."},"duration_seconds":{"type":"integer","enum":[5,10],"default":5,"description":"Duration in seconds."},"aspect_ratio":{"type":"string","description":"Output aspect ratio."},"negative_prompt":{"type":"string","description":"Negative prompt."},"cfg_scale":{"type":"number","description":"Guidance scale (0-1)."},"last_frame_image_url":{"type":"string","description":"Final frame image URL for supported image-to-video models."}},"additionalProperties":false,"required":["model","prompt","first_frame_image_url"],"allOf":[{"if":{"properties":{"model":{"const":"kling-o1"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["negative_prompt"]}},{"not":{"required":["cfg_scale"]}}]}},{"if":{"properties":{"model":{"const":"kling-v2.1-master-image-to-video"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["enable_sound"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"properties":{"model":{"const":"kling-v2.1-pro"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["enable_sound"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"properties":{"model":{"const":"kling-v2.1-standard"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["enable_sound"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"properties":{"model":{"const":"kling-v2.5-turbo-image-to-video-pro"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["enable_sound"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"properties":{"model":{"const":"kling-v2.6"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["negative_prompt"]}},{"not":{"required":["cfg_scale"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"allOf":[{"properties":{"mode":{"const":"std"}},"required":["mode"]},{"properties":{"model":{"const":"kling-v2.6"}},"required":["model"]}]},"then":{"properties":{"enable_sound":{"enum":[false]}}}},{"if":{"allOf":[{"not":{"required":["mode"]}},{"properties":{"model":{"const":"kling-v2.6"}},"required":["model"]}]},"then":{"properties":{"enable_sound":{"enum":[false]}}}},{"if":{"properties":{"model":{"const":"kling-v3-omni"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["negative_prompt"]}},{"not":{"required":["cfg_scale"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"properties":{"model":{"const":"kling-v3-turbo-image-to-video"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["enable_sound"]}},{"not":{"required":["aspect_ratio"]}},{"not":{"required":["negative_prompt"]}},{"not":{"required":["cfg_scale"]}},{"not":{"required":["last_frame_image_url"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}}]},{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"kling-v2.6"},"prompt":{"type":"string","maxLength":2500,"minLength":1,"description":"Video description."},"first_frame_image_url":{"type":"string","description":"First frame image URL."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."},"mode":{"type":"string","enum":["std","pro"],"default":"std","description":"Generation mode."},"enable_sound":{"type":"boolean","default":false,"description":"Enable sound generation; requires pro mode."},"duration_seconds":{"type":"integer","enum":[5,10],"default":5,"description":"Duration in seconds."},"aspect_ratio":{"type":"string","enum":["16:9","9:16","1:1"],"default":"16:9","description":"Output aspect ratio."},"last_frame_image_url":{"type":"string","description":"Final frame image URL; requires pro mode and 5 seconds."}},"additionalProperties":false,"required":["model","prompt","first_frame_image_url"],"allOf":[{"if":{"properties":{"model":{"const":"kling-o1"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["negative_prompt"]}},{"not":{"required":["cfg_scale"]}}]}},{"if":{"properties":{"model":{"const":"kling-v2.1-master-image-to-video"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["enable_sound"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"properties":{"model":{"const":"kling-v2.1-pro"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["enable_sound"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"properties":{"model":{"const":"kling-v2.1-standard"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["enable_sound"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"properties":{"model":{"const":"kling-v2.5-turbo-image-to-video-pro"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["enable_sound"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"properties":{"model":{"const":"kling-v2.6"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["negative_prompt"]}},{"not":{"required":["cfg_scale"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"allOf":[{"properties":{"mode":{"const":"std"}},"required":["mode"]},{"properties":{"model":{"const":"kling-v2.6"}},"required":["model"]}]},"then":{"properties":{"enable_sound":{"enum":[false]}}}},{"if":{"allOf":[{"not":{"required":["mode"]}},{"properties":{"model":{"const":"kling-v2.6"}},"required":["model"]}]},"then":{"properties":{"enable_sound":{"enum":[false]}}}},{"if":{"properties":{"model":{"const":"kling-v3-omni"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["negative_prompt"]}},{"not":{"required":["cfg_scale"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"properties":{"model":{"const":"kling-v3-turbo-image-to-video"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["enable_sound"]}},{"not":{"required":["aspect_ratio"]}},{"not":{"required":["negative_prompt"]}},{"not":{"required":["cfg_scale"]}},{"not":{"required":["last_frame_image_url"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}}]},{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"kling-v3-omni"},"prompt":{"type":"string","maxLength":2500,"minLength":1,"description":"Video description."},"first_frame_image_url":{"type":"string","description":"First frame image URL."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."},"enable_sound":{"type":"boolean","default":false,"description":"Enable synchronized sound generation."},"duration_seconds":{"type":"integer","enum":[3,4,5,6,7,8,9,10,11,12,13,14,15],"default":5,"description":"Duration in seconds."},"aspect_ratio":{"type":"string","enum":["16:9","9:16","1:1"],"default":"16:9","description":"Output aspect ratio."},"output_resolution":{"type":"string","enum":["720p","1080p","4k"],"default":"720p","description":"Output resolution."},"last_frame_image_url":{"type":"string","description":"Final frame image URL; requires a 5-second duration."}},"additionalProperties":false,"required":["model","prompt","first_frame_image_url"],"allOf":[{"if":{"properties":{"model":{"const":"kling-o1"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["negative_prompt"]}},{"not":{"required":["cfg_scale"]}}]}},{"if":{"properties":{"model":{"const":"kling-v2.1-master-image-to-video"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["enable_sound"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"properties":{"model":{"const":"kling-v2.1-pro"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["enable_sound"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"properties":{"model":{"const":"kling-v2.1-standard"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["enable_sound"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"properties":{"model":{"const":"kling-v2.5-turbo-image-to-video-pro"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["enable_sound"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"properties":{"model":{"const":"kling-v2.6"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["negative_prompt"]}},{"not":{"required":["cfg_scale"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"allOf":[{"properties":{"mode":{"const":"std"}},"required":["mode"]},{"properties":{"model":{"const":"kling-v2.6"}},"required":["model"]}]},"then":{"properties":{"enable_sound":{"enum":[false]}}}},{"if":{"allOf":[{"not":{"required":["mode"]}},{"properties":{"model":{"const":"kling-v2.6"}},"required":["model"]}]},"then":{"properties":{"enable_sound":{"enum":[false]}}}},{"if":{"properties":{"model":{"const":"kling-v3-omni"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["negative_prompt"]}},{"not":{"required":["cfg_scale"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"properties":{"model":{"const":"kling-v3-turbo-image-to-video"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["enable_sound"]}},{"not":{"required":["aspect_ratio"]}},{"not":{"required":["negative_prompt"]}},{"not":{"required":["cfg_scale"]}},{"not":{"required":["last_frame_image_url"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}}]},{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"kling-v3-turbo-image-to-video"},"prompt":{"type":"string","maxLength":2500,"minLength":1,"description":"Video description."},"first_frame_image_url":{"type":"string","description":"First frame image URL."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."},"duration_seconds":{"type":"integer","enum":[3,4,5,6,7,8,9,10,11,12,13,14,15],"default":5,"description":"Duration in seconds."},"output_resolution":{"type":"string","enum":["720p","1080p"],"default":"720p","description":"Output resolution."}},"additionalProperties":false,"required":["model","prompt","first_frame_image_url"],"allOf":[{"if":{"properties":{"model":{"const":"kling-o1"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["negative_prompt"]}},{"not":{"required":["cfg_scale"]}}]}},{"if":{"properties":{"model":{"const":"kling-v2.1-master-image-to-video"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["enable_sound"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"properties":{"model":{"const":"kling-v2.1-pro"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["enable_sound"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"properties":{"model":{"const":"kling-v2.1-standard"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["enable_sound"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"properties":{"model":{"const":"kling-v2.5-turbo-image-to-video-pro"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["enable_sound"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"properties":{"model":{"const":"kling-v2.6"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["negative_prompt"]}},{"not":{"required":["cfg_scale"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"allOf":[{"properties":{"mode":{"const":"std"}},"required":["mode"]},{"properties":{"model":{"const":"kling-v2.6"}},"required":["model"]}]},"then":{"properties":{"enable_sound":{"enum":[false]}}}},{"if":{"allOf":[{"not":{"required":["mode"]}},{"properties":{"model":{"const":"kling-v2.6"}},"required":["model"]}]},"then":{"properties":{"enable_sound":{"enum":[false]}}}},{"if":{"properties":{"model":{"const":"kling-v3-omni"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["negative_prompt"]}},{"not":{"required":["cfg_scale"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"properties":{"model":{"const":"kling-v3-turbo-image-to-video"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["enable_sound"]}},{"not":{"required":["aspect_ratio"]}},{"not":{"required":["negative_prompt"]}},{"not":{"required":["cfg_scale"]}},{"not":{"required":["last_frame_image_url"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}}]}]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/kling/image_to_video/{id}":{"get":{"tags":["Kling"],"summary":"Retrieve Kling Image-to-Video task","description":"Create an asynchronous task through the Kling image to video endpoint.","operationId":"task_endpoint_kling_image_to_video_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","videos","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"videos":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/kling/motion_control":{"post":{"tags":["Kling"],"summary":"Kling Motion-Control","description":"Create an asynchronous task through the Kling motion control endpoint.","operationId":"task_endpoint_kling_motion_control","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"kling-3.0"},"source_image_url":{"type":"string","description":"Subject image URL."},"reference_video_url":{"type":"string","description":"Reference motion video URL."},"prompt":{"type":"string","description":"Description prompt."},"output_resolution":{"type":"string","enum":["720p","1080p"],"description":"Output resolution."},"character_orientation":{"type":"string","enum":["video","image"],"description":"Character orientation."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."}},"additionalProperties":false,"required":["model","source_image_url","reference_video_url","output_resolution"]},{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"kling-v2.6"},"source_image_url":{"type":"string","description":"Subject image URL."},"reference_video_url":{"type":"string","description":"Reference motion video URL (3-10 seconds with image orientation; 3-30 seconds with video orientation)."},"prompt":{"type":"string","maxLength":2500,"description":"Optional motion guidance prompt."},"output_resolution":{"type":"string","enum":["720p","1080p"],"description":"Output resolution."},"character_orientation":{"type":"string","enum":["video","image"],"description":"Whether the reference follows the video's or image's orientation."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."}},"additionalProperties":false,"required":["model","source_image_url","reference_video_url","output_resolution","character_orientation"]}]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/kling/motion_control/{id}":{"get":{"tags":["Kling"],"summary":"Retrieve Kling Motion-Control task","description":"Create an asynchronous task through the Kling motion control endpoint.","operationId":"task_endpoint_kling_motion_control_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","videos","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"videos":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/kling/text_to_video":{"post":{"tags":["Kling"],"summary":"Kling Text-to-Video","description":"Create an asynchronous task through the Kling text to video endpoint.","operationId":"task_endpoint_kling_text_to_video","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"kling-3.0"},"prompt":{"type":"string","description":"Video description. Required for single-shot and automatic storyboarding."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."},"enable_sound":{"type":"boolean","default":false,"description":"Enable sound generation."},"duration_seconds":{"type":"integer","enum":[3,4,5,6,7,8,9,10,11,12,13,14,15],"default":5,"description":"Duration in seconds."},"aspect_ratio":{"type":"string","enum":["16:9","9:16","1:1"],"default":"16:9","description":"Output aspect ratio."},"output_resolution":{"type":"string","enum":["720p","1080p","4k"],"default":"1080p","description":"Output resolution."},"negative_prompt":{"type":"string","description":"Negative prompt."},"cfg_scale":{"type":"number","description":"Guidance scale (0-1)."},"multi_shots":{"type":"boolean","description":"Enable multi-shot generation."},"shot_type":{"type":"string","enum":["custom","automatic"],"description":"Multi-shot storyboard method: custom or automatic; defaults to custom only when multi_shots is true."},"multi_prompt":{"type":"array","description":"Required for custom multi-shot mode: 1–6 shots with nonempty prompts up to 500 characters (each @element reference counts as 37), each duration_seconds 1–12, summing to duration_seconds."},"first_frame_image_url":{"type":"string","description":"First frame image URL."},"last_frame_image_url":{"type":"string","description":"Last frame image URL for single-shot mode."},"kling_elements":{"type":"array","description":"Element references with image, video, or audio materials."}},"additionalProperties":false,"required":["model"],"allOf":[{"if":{"properties":{"model":{"const":"kling-3.0"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"properties":{"model":{"const":"kling-o1"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["negative_prompt"]}},{"not":{"required":["cfg_scale"]}},{"not":{"required":["multi_shots"]}},{"not":{"required":["multi_prompt"]}},{"not":{"required":["first_frame_image_url"]}},{"not":{"required":["last_frame_image_url"]}},{"not":{"required":["kling_elements"]}}]}},{"if":{"properties":{"model":{"const":"kling-v2.1-master-text-to-video"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["mode"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"properties":{"model":{"const":"kling-v2.5-turbo-text-to-video-pro"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["mode"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"properties":{"model":{"const":"kling-v2.6"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["negative_prompt"]}},{"not":{"required":["cfg_scale"]}},{"not":{"required":["multi_shots"]}},{"not":{"required":["multi_prompt"]}},{"not":{"required":["first_frame_image_url"]}},{"not":{"required":["last_frame_image_url"]}},{"not":{"required":["kling_elements"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"allOf":[{"properties":{"mode":{"const":"std"}},"required":["mode"]},{"properties":{"model":{"const":"kling-v2.6"}},"required":["model"]}]},"then":{"properties":{"enable_sound":{"enum":[false]}}}},{"if":{"allOf":[{"not":{"required":["mode"]}},{"properties":{"model":{"const":"kling-v2.6"}},"required":["model"]}]},"then":{"properties":{"enable_sound":{"enum":[false]}}}},{"if":{"properties":{"model":{"const":"kling-v3-omni"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["negative_prompt"]}},{"not":{"required":["cfg_scale"]}},{"not":{"required":["multi_shots"]}},{"not":{"required":["multi_prompt"]}},{"not":{"required":["first_frame_image_url"]}},{"not":{"required":["last_frame_image_url"]}},{"not":{"required":["kling_elements"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"properties":{"model":{"const":"kling-v3-turbo-text-to-video"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["enable_sound"]}},{"not":{"required":["negative_prompt"]}},{"not":{"required":["cfg_scale"]}},{"not":{"required":["multi_shots"]}},{"not":{"required":["multi_prompt"]}},{"not":{"required":["first_frame_image_url"]}},{"not":{"required":["last_frame_image_url"]}},{"not":{"required":["kling_elements"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}}]},{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"kling-o1"},"prompt":{"type":"string","maxLength":2500,"minLength":1,"description":"Video description; reference media with matching numbered markers."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."},"mode":{"type":"string","enum":["std","pro"],"default":"std","description":"Generation mode."},"enable_sound":{"type":"boolean","default":false,"description":"Sound generation must remain disabled."},"duration_seconds":{"type":"integer","enum":[5],"default":5,"description":"Duration in seconds."},"aspect_ratio":{"type":"string","enum":["16:9","9:16","1:1"],"default":"16:9","description":"Output aspect ratio."},"reference_image_urls":{"type":"array","items":{"type":"string"},"maxItems":7,"minItems":1,"description":"Ordered public HTTP(S) JPG, JPEG, or PNG reference image URLs."},"reference_video_url":{"type":"string","description":"Public HTTP(S) MP4 or MOV reference video URL."},"reference_video_type":{"type":"string","enum":["base","feature"],"default":"base","description":"Use the video as a base edit or feature reference."},"preserve_reference_video_audio":{"type":"boolean","default":false,"description":"Preserve the reference video's original audio."}},"additionalProperties":false,"required":["model","prompt"],"allOf":[{"if":{"properties":{"model":{"const":"kling-3.0"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"properties":{"model":{"const":"kling-o1"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["negative_prompt"]}},{"not":{"required":["cfg_scale"]}},{"not":{"required":["multi_shots"]}},{"not":{"required":["multi_prompt"]}},{"not":{"required":["first_frame_image_url"]}},{"not":{"required":["last_frame_image_url"]}},{"not":{"required":["kling_elements"]}}]}},{"if":{"properties":{"model":{"const":"kling-v2.1-master-text-to-video"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["mode"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"properties":{"model":{"const":"kling-v2.5-turbo-text-to-video-pro"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["mode"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"properties":{"model":{"const":"kling-v2.6"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["negative_prompt"]}},{"not":{"required":["cfg_scale"]}},{"not":{"required":["multi_shots"]}},{"not":{"required":["multi_prompt"]}},{"not":{"required":["first_frame_image_url"]}},{"not":{"required":["last_frame_image_url"]}},{"not":{"required":["kling_elements"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"allOf":[{"properties":{"mode":{"const":"std"}},"required":["mode"]},{"properties":{"model":{"const":"kling-v2.6"}},"required":["model"]}]},"then":{"properties":{"enable_sound":{"enum":[false]}}}},{"if":{"allOf":[{"not":{"required":["mode"]}},{"properties":{"model":{"const":"kling-v2.6"}},"required":["model"]}]},"then":{"properties":{"enable_sound":{"enum":[false]}}}},{"if":{"properties":{"model":{"const":"kling-v3-omni"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["negative_prompt"]}},{"not":{"required":["cfg_scale"]}},{"not":{"required":["multi_shots"]}},{"not":{"required":["multi_prompt"]}},{"not":{"required":["first_frame_image_url"]}},{"not":{"required":["last_frame_image_url"]}},{"not":{"required":["kling_elements"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"properties":{"model":{"const":"kling-v3-turbo-text-to-video"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["enable_sound"]}},{"not":{"required":["negative_prompt"]}},{"not":{"required":["cfg_scale"]}},{"not":{"required":["multi_shots"]}},{"not":{"required":["multi_prompt"]}},{"not":{"required":["first_frame_image_url"]}},{"not":{"required":["last_frame_image_url"]}},{"not":{"required":["kling_elements"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}}]},{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"kling-v2.1-master-text-to-video"},"prompt":{"type":"string","description":"Video description."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."},"enable_sound":{"type":"boolean","description":"Enable sound generation."},"duration_seconds":{"type":"integer","enum":[5,10],"default":5,"description":"Duration in seconds."},"aspect_ratio":{"type":"string","enum":["16:9","9:16","1:1"],"default":"16:9","description":"Output aspect ratio."},"negative_prompt":{"type":"string","description":"Negative prompt."},"cfg_scale":{"type":"number","description":"Guidance scale (0-1)."}},"additionalProperties":false,"required":["model"],"allOf":[{"if":{"properties":{"model":{"const":"kling-3.0"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"properties":{"model":{"const":"kling-o1"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["negative_prompt"]}},{"not":{"required":["cfg_scale"]}},{"not":{"required":["multi_shots"]}},{"not":{"required":["multi_prompt"]}},{"not":{"required":["first_frame_image_url"]}},{"not":{"required":["last_frame_image_url"]}},{"not":{"required":["kling_elements"]}}]}},{"if":{"properties":{"model":{"const":"kling-v2.1-master-text-to-video"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["mode"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"properties":{"model":{"const":"kling-v2.5-turbo-text-to-video-pro"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["mode"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"properties":{"model":{"const":"kling-v2.6"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["negative_prompt"]}},{"not":{"required":["cfg_scale"]}},{"not":{"required":["multi_shots"]}},{"not":{"required":["multi_prompt"]}},{"not":{"required":["first_frame_image_url"]}},{"not":{"required":["last_frame_image_url"]}},{"not":{"required":["kling_elements"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"allOf":[{"properties":{"mode":{"const":"std"}},"required":["mode"]},{"properties":{"model":{"const":"kling-v2.6"}},"required":["model"]}]},"then":{"properties":{"enable_sound":{"enum":[false]}}}},{"if":{"allOf":[{"not":{"required":["mode"]}},{"properties":{"model":{"const":"kling-v2.6"}},"required":["model"]}]},"then":{"properties":{"enable_sound":{"enum":[false]}}}},{"if":{"properties":{"model":{"const":"kling-v3-omni"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["negative_prompt"]}},{"not":{"required":["cfg_scale"]}},{"not":{"required":["multi_shots"]}},{"not":{"required":["multi_prompt"]}},{"not":{"required":["first_frame_image_url"]}},{"not":{"required":["last_frame_image_url"]}},{"not":{"required":["kling_elements"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"properties":{"model":{"const":"kling-v3-turbo-text-to-video"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["enable_sound"]}},{"not":{"required":["negative_prompt"]}},{"not":{"required":["cfg_scale"]}},{"not":{"required":["multi_shots"]}},{"not":{"required":["multi_prompt"]}},{"not":{"required":["first_frame_image_url"]}},{"not":{"required":["last_frame_image_url"]}},{"not":{"required":["kling_elements"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}}]},{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"kling-v2.5-turbo-text-to-video-pro"},"prompt":{"type":"string","description":"Video description."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."},"enable_sound":{"type":"boolean","description":"Enable sound generation."},"duration_seconds":{"type":"integer","enum":[5,10],"default":5,"description":"Duration in seconds."},"aspect_ratio":{"type":"string","enum":["16:9","9:16","1:1"],"default":"16:9","description":"Output aspect ratio."},"negative_prompt":{"type":"string","description":"Negative prompt."},"cfg_scale":{"type":"number","description":"Guidance scale (0-1)."}},"additionalProperties":false,"required":["model"],"allOf":[{"if":{"properties":{"model":{"const":"kling-3.0"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"properties":{"model":{"const":"kling-o1"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["negative_prompt"]}},{"not":{"required":["cfg_scale"]}},{"not":{"required":["multi_shots"]}},{"not":{"required":["multi_prompt"]}},{"not":{"required":["first_frame_image_url"]}},{"not":{"required":["last_frame_image_url"]}},{"not":{"required":["kling_elements"]}}]}},{"if":{"properties":{"model":{"const":"kling-v2.1-master-text-to-video"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["mode"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"properties":{"model":{"const":"kling-v2.5-turbo-text-to-video-pro"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["mode"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"properties":{"model":{"const":"kling-v2.6"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["negative_prompt"]}},{"not":{"required":["cfg_scale"]}},{"not":{"required":["multi_shots"]}},{"not":{"required":["multi_prompt"]}},{"not":{"required":["first_frame_image_url"]}},{"not":{"required":["last_frame_image_url"]}},{"not":{"required":["kling_elements"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"allOf":[{"properties":{"mode":{"const":"std"}},"required":["mode"]},{"properties":{"model":{"const":"kling-v2.6"}},"required":["model"]}]},"then":{"properties":{"enable_sound":{"enum":[false]}}}},{"if":{"allOf":[{"not":{"required":["mode"]}},{"properties":{"model":{"const":"kling-v2.6"}},"required":["model"]}]},"then":{"properties":{"enable_sound":{"enum":[false]}}}},{"if":{"properties":{"model":{"const":"kling-v3-omni"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["negative_prompt"]}},{"not":{"required":["cfg_scale"]}},{"not":{"required":["multi_shots"]}},{"not":{"required":["multi_prompt"]}},{"not":{"required":["first_frame_image_url"]}},{"not":{"required":["last_frame_image_url"]}},{"not":{"required":["kling_elements"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"properties":{"model":{"const":"kling-v3-turbo-text-to-video"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["enable_sound"]}},{"not":{"required":["negative_prompt"]}},{"not":{"required":["cfg_scale"]}},{"not":{"required":["multi_shots"]}},{"not":{"required":["multi_prompt"]}},{"not":{"required":["first_frame_image_url"]}},{"not":{"required":["last_frame_image_url"]}},{"not":{"required":["kling_elements"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}}]},{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"kling-v2.6"},"prompt":{"type":"string","maxLength":2500,"minLength":1,"description":"Video description."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."},"mode":{"type":"string","enum":["std","pro"],"default":"std","description":"Generation mode."},"enable_sound":{"type":"boolean","default":false,"description":"Enable sound generation; requires pro mode."},"duration_seconds":{"type":"integer","enum":[5,10],"default":5,"description":"Duration in seconds."},"aspect_ratio":{"type":"string","enum":["16:9","9:16","1:1"],"default":"16:9","description":"Output aspect ratio."}},"additionalProperties":false,"required":["model","prompt"],"allOf":[{"if":{"properties":{"model":{"const":"kling-3.0"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"properties":{"model":{"const":"kling-o1"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["negative_prompt"]}},{"not":{"required":["cfg_scale"]}},{"not":{"required":["multi_shots"]}},{"not":{"required":["multi_prompt"]}},{"not":{"required":["first_frame_image_url"]}},{"not":{"required":["last_frame_image_url"]}},{"not":{"required":["kling_elements"]}}]}},{"if":{"properties":{"model":{"const":"kling-v2.1-master-text-to-video"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["mode"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"properties":{"model":{"const":"kling-v2.5-turbo-text-to-video-pro"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["mode"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"properties":{"model":{"const":"kling-v2.6"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["negative_prompt"]}},{"not":{"required":["cfg_scale"]}},{"not":{"required":["multi_shots"]}},{"not":{"required":["multi_prompt"]}},{"not":{"required":["first_frame_image_url"]}},{"not":{"required":["last_frame_image_url"]}},{"not":{"required":["kling_elements"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"allOf":[{"properties":{"mode":{"const":"std"}},"required":["mode"]},{"properties":{"model":{"const":"kling-v2.6"}},"required":["model"]}]},"then":{"properties":{"enable_sound":{"enum":[false]}}}},{"if":{"allOf":[{"not":{"required":["mode"]}},{"properties":{"model":{"const":"kling-v2.6"}},"required":["model"]}]},"then":{"properties":{"enable_sound":{"enum":[false]}}}},{"if":{"properties":{"model":{"const":"kling-v3-omni"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["negative_prompt"]}},{"not":{"required":["cfg_scale"]}},{"not":{"required":["multi_shots"]}},{"not":{"required":["multi_prompt"]}},{"not":{"required":["first_frame_image_url"]}},{"not":{"required":["last_frame_image_url"]}},{"not":{"required":["kling_elements"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"properties":{"model":{"const":"kling-v3-turbo-text-to-video"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["enable_sound"]}},{"not":{"required":["negative_prompt"]}},{"not":{"required":["cfg_scale"]}},{"not":{"required":["multi_shots"]}},{"not":{"required":["multi_prompt"]}},{"not":{"required":["first_frame_image_url"]}},{"not":{"required":["last_frame_image_url"]}},{"not":{"required":["kling_elements"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}}]},{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"kling-v3-omni"},"prompt":{"type":"string","maxLength":2500,"minLength":1,"description":"Video description."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."},"enable_sound":{"type":"boolean","default":false,"description":"Enable synchronized sound generation."},"duration_seconds":{"type":"integer","enum":[3,4,5,6,7,8,9,10,11,12,13,14,15],"default":5,"description":"Duration in seconds."},"aspect_ratio":{"type":"string","enum":["16:9","9:16","1:1"],"default":"16:9","description":"Output aspect ratio."},"output_resolution":{"type":"string","enum":["720p","1080p","4k"],"default":"720p","description":"Output resolution."}},"additionalProperties":false,"required":["model","prompt"],"allOf":[{"if":{"properties":{"model":{"const":"kling-3.0"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"properties":{"model":{"const":"kling-o1"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["negative_prompt"]}},{"not":{"required":["cfg_scale"]}},{"not":{"required":["multi_shots"]}},{"not":{"required":["multi_prompt"]}},{"not":{"required":["first_frame_image_url"]}},{"not":{"required":["last_frame_image_url"]}},{"not":{"required":["kling_elements"]}}]}},{"if":{"properties":{"model":{"const":"kling-v2.1-master-text-to-video"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["mode"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"properties":{"model":{"const":"kling-v2.5-turbo-text-to-video-pro"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["mode"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"properties":{"model":{"const":"kling-v2.6"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["negative_prompt"]}},{"not":{"required":["cfg_scale"]}},{"not":{"required":["multi_shots"]}},{"not":{"required":["multi_prompt"]}},{"not":{"required":["first_frame_image_url"]}},{"not":{"required":["last_frame_image_url"]}},{"not":{"required":["kling_elements"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"allOf":[{"properties":{"mode":{"const":"std"}},"required":["mode"]},{"properties":{"model":{"const":"kling-v2.6"}},"required":["model"]}]},"then":{"properties":{"enable_sound":{"enum":[false]}}}},{"if":{"allOf":[{"not":{"required":["mode"]}},{"properties":{"model":{"const":"kling-v2.6"}},"required":["model"]}]},"then":{"properties":{"enable_sound":{"enum":[false]}}}},{"if":{"properties":{"model":{"const":"kling-v3-omni"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["negative_prompt"]}},{"not":{"required":["cfg_scale"]}},{"not":{"required":["multi_shots"]}},{"not":{"required":["multi_prompt"]}},{"not":{"required":["first_frame_image_url"]}},{"not":{"required":["last_frame_image_url"]}},{"not":{"required":["kling_elements"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"properties":{"model":{"const":"kling-v3-turbo-text-to-video"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["enable_sound"]}},{"not":{"required":["negative_prompt"]}},{"not":{"required":["cfg_scale"]}},{"not":{"required":["multi_shots"]}},{"not":{"required":["multi_prompt"]}},{"not":{"required":["first_frame_image_url"]}},{"not":{"required":["last_frame_image_url"]}},{"not":{"required":["kling_elements"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}}]},{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"kling-v3-omni-reference"},"prompt":{"type":"string","maxLength":2500,"minLength":1,"description":"Video description."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."},"enable_sound":{"type":"boolean","default":false,"description":"Enable synchronized sound generation."},"duration_seconds":{"type":"integer","enum":[3,4,5,6,7,8,9,10,11,12,13,14,15],"default":5,"description":"Output duration in seconds."},"aspect_ratio":{"type":"string","enum":["16:9","9:16","1:1"],"description":"Output aspect ratio."},"output_resolution":{"type":"string","enum":["720p","1080p","4k"],"default":"720p","description":"Output resolution."},"reference_image_urls":{"type":"array","items":{"type":"string"},"maxItems":7,"minItems":1,"description":"Ordered reference image URLs."}},"additionalProperties":false,"required":["model","prompt","aspect_ratio","reference_image_urls"],"allOf":[{"if":{"properties":{"model":{"const":"kling-3.0"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"properties":{"model":{"const":"kling-o1"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["negative_prompt"]}},{"not":{"required":["cfg_scale"]}},{"not":{"required":["multi_shots"]}},{"not":{"required":["multi_prompt"]}},{"not":{"required":["first_frame_image_url"]}},{"not":{"required":["last_frame_image_url"]}},{"not":{"required":["kling_elements"]}}]}},{"if":{"properties":{"model":{"const":"kling-v2.1-master-text-to-video"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["mode"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"properties":{"model":{"const":"kling-v2.5-turbo-text-to-video-pro"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["mode"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"properties":{"model":{"const":"kling-v2.6"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["negative_prompt"]}},{"not":{"required":["cfg_scale"]}},{"not":{"required":["multi_shots"]}},{"not":{"required":["multi_prompt"]}},{"not":{"required":["first_frame_image_url"]}},{"not":{"required":["last_frame_image_url"]}},{"not":{"required":["kling_elements"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"allOf":[{"properties":{"mode":{"const":"std"}},"required":["mode"]},{"properties":{"model":{"const":"kling-v2.6"}},"required":["model"]}]},"then":{"properties":{"enable_sound":{"enum":[false]}}}},{"if":{"allOf":[{"not":{"required":["mode"]}},{"properties":{"model":{"const":"kling-v2.6"}},"required":["model"]}]},"then":{"properties":{"enable_sound":{"enum":[false]}}}},{"if":{"properties":{"model":{"const":"kling-v3-omni"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["negative_prompt"]}},{"not":{"required":["cfg_scale"]}},{"not":{"required":["multi_shots"]}},{"not":{"required":["multi_prompt"]}},{"not":{"required":["first_frame_image_url"]}},{"not":{"required":["last_frame_image_url"]}},{"not":{"required":["kling_elements"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"properties":{"model":{"const":"kling-v3-turbo-text-to-video"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["enable_sound"]}},{"not":{"required":["negative_prompt"]}},{"not":{"required":["cfg_scale"]}},{"not":{"required":["multi_shots"]}},{"not":{"required":["multi_prompt"]}},{"not":{"required":["first_frame_image_url"]}},{"not":{"required":["last_frame_image_url"]}},{"not":{"required":["kling_elements"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}}]},{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"kling-v3-turbo-text-to-video"},"prompt":{"type":"string","maxLength":2500,"minLength":1,"description":"Video description."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."},"duration_seconds":{"type":"integer","enum":[3,4,5,6,7,8,9,10,11,12,13,14,15],"default":5,"description":"Duration in seconds."},"aspect_ratio":{"type":"string","enum":["16:9","9:16","1:1"],"default":"16:9","description":"Output aspect ratio."},"output_resolution":{"type":"string","enum":["720p","1080p"],"default":"720p","description":"Output resolution."}},"additionalProperties":false,"required":["model","prompt"],"allOf":[{"if":{"properties":{"model":{"const":"kling-3.0"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"properties":{"model":{"const":"kling-o1"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["negative_prompt"]}},{"not":{"required":["cfg_scale"]}},{"not":{"required":["multi_shots"]}},{"not":{"required":["multi_prompt"]}},{"not":{"required":["first_frame_image_url"]}},{"not":{"required":["last_frame_image_url"]}},{"not":{"required":["kling_elements"]}}]}},{"if":{"properties":{"model":{"const":"kling-v2.1-master-text-to-video"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["mode"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"properties":{"model":{"const":"kling-v2.5-turbo-text-to-video-pro"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["mode"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"properties":{"model":{"const":"kling-v2.6"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["negative_prompt"]}},{"not":{"required":["cfg_scale"]}},{"not":{"required":["multi_shots"]}},{"not":{"required":["multi_prompt"]}},{"not":{"required":["first_frame_image_url"]}},{"not":{"required":["last_frame_image_url"]}},{"not":{"required":["kling_elements"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"allOf":[{"properties":{"mode":{"const":"std"}},"required":["mode"]},{"properties":{"model":{"const":"kling-v2.6"}},"required":["model"]}]},"then":{"properties":{"enable_sound":{"enum":[false]}}}},{"if":{"allOf":[{"not":{"required":["mode"]}},{"properties":{"model":{"const":"kling-v2.6"}},"required":["model"]}]},"then":{"properties":{"enable_sound":{"enum":[false]}}}},{"if":{"properties":{"model":{"const":"kling-v3-omni"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["negative_prompt"]}},{"not":{"required":["cfg_scale"]}},{"not":{"required":["multi_shots"]}},{"not":{"required":["multi_prompt"]}},{"not":{"required":["first_frame_image_url"]}},{"not":{"required":["last_frame_image_url"]}},{"not":{"required":["kling_elements"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}},{"if":{"properties":{"model":{"const":"kling-v3-turbo-text-to-video"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["enable_sound"]}},{"not":{"required":["negative_prompt"]}},{"not":{"required":["cfg_scale"]}},{"not":{"required":["multi_shots"]}},{"not":{"required":["multi_prompt"]}},{"not":{"required":["first_frame_image_url"]}},{"not":{"required":["last_frame_image_url"]}},{"not":{"required":["kling_elements"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_url"]}},{"not":{"required":["reference_video_type"]}},{"not":{"required":["preserve_reference_video_audio"]}}]}}]}]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/kling/text_to_video/{id}":{"get":{"tags":["Kling"],"summary":"Retrieve Kling Text-to-Video task","description":"Create an asynchronous task through the Kling text to video endpoint.","operationId":"task_endpoint_kling_text_to_video_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","videos","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"videos":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/luma/modify_video/{id}":{"get":{"tags":["Luma"],"summary":"Retrieve Luma Modify-Video task","description":"This endpoint is retired. New requests return HTTP 410. Existing tasks remain queryable.","operationId":"task_endpoint_luma_modify_video_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","videos","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"videos":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"sources":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string"}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/midjourney/edit_image":{"post":{"tags":["Midjourney"],"summary":"Midjourney Edit-Image","description":"Create an asynchronous task through the Midjourney edit image endpoint.","operationId":"task_endpoint_midjourney_edit_image","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"model":{"type":"string","const":"midjourney-edit-image"},"prompt":{"type":"string"},"source_image_url":{"type":"string"},"mask_url":{"type":"string"},"include_split_images":{"type":"boolean","default":false},"callback_url":{"type":"string"}},"additionalProperties":false,"required":["prompt","source_image_url","model"]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/midjourney/edit_image/{id}":{"get":{"tags":["Midjourney"],"summary":"Retrieve Midjourney Edit-Image task","description":"Create an asynchronous task through the Midjourney edit image endpoint.","operationId":"task_endpoint_midjourney_edit_image_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"progress":{"type":"integer"}},"unevaluatedProperties":false},{"type":"object","required":["id","status","images","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"images":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"image_id":{"type":"string"},"actions":{"type":"array","items":{"type":"string"}},"progress":{"type":"integer"},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/midjourney/extend_video":{"post":{"tags":["Midjourney"],"summary":"Midjourney Extend-Video","description":"Create an asynchronous task through the Midjourney extend video endpoint.","operationId":"task_endpoint_midjourney_extend_video","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"source_task_id":{"type":"string"},"prompt":{"type":"string"},"callback_url":{"type":"string"},"model":{"type":"string","const":"midjourney-image-to-video"}},"additionalProperties":false,"required":["source_task_id","model"]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/midjourney/extend_video/{id}":{"get":{"tags":["Midjourney"],"summary":"Retrieve Midjourney Extend-Video task","description":"Create an asynchronous task through the Midjourney extend video endpoint.","operationId":"task_endpoint_midjourney_extend_video_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"progress":{"type":"integer"}},"unevaluatedProperties":false},{"type":"object","required":["id","status","videos","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"videos":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"video_id":{"type":"string"},"progress":{"type":"integer"},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/midjourney/get_seed":{"post":{"tags":["Midjourney"],"summary":"Midjourney Get-Seed","description":"Send a synchronous request through the Midjourney get seed endpoint.","operationId":"task_endpoint_midjourney_get_seed","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"image_id":{"type":"string"}},"additionalProperties":false,"required":["image_id"]}}}},"responses":{"200":{"description":"Sync success","content":{"application/json":{"schema":{"type":"object","required":["seed"],"properties":{"seed":{"type":"integer"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Referenced image not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/midjourney/image_to_prompt":{"post":{"tags":["Midjourney"],"summary":"Midjourney Image-to-Prompt","description":"Send a synchronous request through the Midjourney image to prompt endpoint.","operationId":"task_endpoint_midjourney_image_to_prompt","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"source_image_url":{"type":"string"}},"additionalProperties":false,"required":["source_image_url"]}}}},"responses":{"200":{"description":"Sync success","content":{"application/json":{"schema":{"type":"object","required":["prompts"],"properties":{"prompts":{"type":"array","minItems":4,"maxItems":4,"items":{"type":"string"}}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"502":{"description":"Bad gateway","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/midjourney/image_to_video":{"post":{"tags":["Midjourney"],"summary":"Midjourney Image-to-Video","description":"Create an asynchronous task through the Midjourney image to video endpoint.","operationId":"task_endpoint_midjourney_image_to_video","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"model":{"type":"string","const":"midjourney-image-to-video"},"prompt":{"type":"string"},"source_image_url":{"type":"string"},"last_frame_image_url":{"type":"string"},"output_resolution":{"type":"string","enum":["480p"],"default":"480p"},"enable_loop":{"type":"boolean","default":false},"callback_url":{"type":"string"}},"additionalProperties":false,"required":["source_image_url","model"]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/midjourney/image_to_video/{id}":{"get":{"tags":["Midjourney"],"summary":"Retrieve Midjourney Image-to-Video task","description":"Create an asynchronous task through the Midjourney image to video endpoint.","operationId":"task_endpoint_midjourney_image_to_video_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"progress":{"type":"integer"}},"unevaluatedProperties":false},{"type":"object","required":["id","status","videos","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"videos":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"video_id":{"type":"string"},"progress":{"type":"integer"},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/midjourney/shorten_prompt":{"post":{"tags":["Midjourney"],"summary":"Midjourney Shorten-Prompt","description":"Send a synchronous request through the Midjourney shorten prompt endpoint.","operationId":"task_endpoint_midjourney_shorten_prompt","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string"}},"additionalProperties":false,"required":["prompt"]}}}},"responses":{"200":{"description":"Sync success","content":{"application/json":{"schema":{"type":"object","required":["prompts"],"properties":{"prompts":{"type":"array","minItems":1,"maxItems":5,"items":{"type":"string"}}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request or Provider bad request","content":{"application/json":{"schema":{"oneOf":[{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]},{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited or Provider rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"502":{"description":"Bad gateway","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/midjourney/text_to_image":{"post":{"tags":["Midjourney"],"summary":"Midjourney Text-to-Image","description":"Create an asynchronous task through the Midjourney text to image endpoint.","operationId":"task_endpoint_midjourney_text_to_image","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"model":{"type":"string","const":"midjourney-v8.1"},"prompt":{"type":"string"},"enable_prompt_translation":{"type":"boolean","default":false},"include_split_images":{"type":"boolean","default":false},"callback_url":{"type":"string"}},"additionalProperties":false,"required":["prompt","model"]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/midjourney/text_to_image/{id}":{"get":{"tags":["Midjourney"],"summary":"Retrieve Midjourney Text-to-Image task","description":"Create an asynchronous task through the Midjourney text to image endpoint.","operationId":"task_endpoint_midjourney_text_to_image_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"progress":{"type":"integer"}},"unevaluatedProperties":false},{"type":"object","required":["id","status","images","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"images":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"image_id":{"type":"string"},"actions":{"type":"array","items":{"type":"string"}},"progress":{"type":"integer"},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/minimax_h3/image_to_video":{"post":{"tags":["MiniMax H3"],"summary":"MiniMax H3 Image-to-Video","description":"Create an asynchronous task through the MiniMax H3 image to video endpoint.","operationId":"task_endpoint_minimax_h3_image_to_video","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"minimax-h3"},"prompt":{"type":"string","maxLength":7000,"minLength":1,"description":"Video generation prompt."},"first_frame_image_url":{"type":"string","pattern":"^https?://","description":"Public HTTP(S) first-frame image URL; JPG, JPEG, PNG, WEBP, HEIC, or HEIF, up to 30 MB, 256-5760 pixels per side, with aspect ratio 0.4-2.5."},"last_frame_image_url":{"type":"string","pattern":"^https?://","description":"Public HTTP(S) final-frame image URL; JPG, JPEG, PNG, WEBP, HEIC, or HEIF, up to 30 MB, 256-5760 pixels per side, with aspect ratio 0.4-2.5."},"duration_seconds":{"type":"integer","enum":[4,5,6,7,8,9,10,11,12,13,14,15],"default":6,"description":"Generated video duration in seconds."},"output_resolution":{"type":"string","enum":["768p","2k"],"default":"2k","description":"Generated video resolution."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."}},"additionalProperties":false,"required":["model","prompt"],"allOf":[{"if":{},"then":{"anyOf":[{"required":["first_frame_image_url"]},{"required":["last_frame_image_url"]}]}}]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/minimax_h3/image_to_video/{id}":{"get":{"tags":["MiniMax H3"],"summary":"Retrieve MiniMax H3 Image-to-Video task","description":"Create an asynchronous task through the MiniMax H3 image to video endpoint.","operationId":"task_endpoint_minimax_h3_image_to_video_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","videos","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"videos":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/minimax_h3/text_to_video":{"post":{"tags":["MiniMax H3"],"summary":"MiniMax H3 Text-to-Video","description":"Create an asynchronous task through the MiniMax H3 text to video endpoint.","operationId":"task_endpoint_minimax_h3_text_to_video","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"minimax-h3"},"prompt":{"type":"string","maxLength":7000,"minLength":1,"description":"Video generation prompt."},"duration_seconds":{"type":"integer","enum":[4,5,6,7,8,9,10,11,12,13,14,15],"default":6,"description":"Generated video duration in seconds."},"output_resolution":{"type":"string","enum":["768p","2k"],"default":"2k","description":"Generated video resolution."},"aspect_ratio":{"type":"string","enum":["adaptive","21:9","16:9","4:3","1:1","3:4","9:16"],"description":"Generated video aspect ratio; adaptive is available only with reference media."},"reference_image_urls":{"type":"array","items":{"type":"string","pattern":"^https?://"},"maxItems":9,"description":"Public HTTP(S) reference image URLs; JPG, JPEG, PNG, WEBP, HEIC, or HEIF, up to 30 MB each, 256-5760 pixels per side, with aspect ratio 0.4-2.5."},"reference_video_urls":{"type":"array","items":{"type":"string","pattern":"^https?://"},"maxItems":3,"description":"Public HTTP(S) MP4 or MOV reference video URLs; each clip must be 2-15 seconds and combined video duration must not exceed 15 seconds."},"reference_audio_urls":{"type":"array","items":{"type":"string","pattern":"^https?://"},"maxItems":3,"description":"Public HTTP(S) WAV or MP3 reference audio URLs; requires reference images or videos, each clip must be 2-15 seconds, and combined audio duration must not exceed 15 seconds."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."}},"additionalProperties":false,"required":["model","prompt"],"allOf":[{"if":{"required":["reference_audio_urls"]},"then":{"anyOf":[{"required":["reference_image_urls"]},{"required":["reference_video_urls"]}]}},{"if":{"allOf":[{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_urls"]}}]},"then":{"allOf":[{"required":["aspect_ratio"]},{"properties":{"aspect_ratio":{"enum":["21:9","16:9","4:3","1:1","3:4","9:16"]}}}]}}]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/minimax_h3/text_to_video/{id}":{"get":{"tags":["MiniMax H3"],"summary":"Retrieve MiniMax H3 Text-to-Video task","description":"Create an asynchronous task through the MiniMax H3 text to video endpoint.","operationId":"task_endpoint_minimax_h3_text_to_video_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","videos","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"videos":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/music_from_sample":{"post":{"tags":["Suno"],"summary":"Suno Music-From-Sample","description":"Create an asynchronous task through the Suno music from sample endpoint.","operationId":"task_endpoint_suno_music_from_sample","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"suno-v4"},"audio_url":{"type":"string","description":"URL of the audio file to sample."},"prompt":{"type":"string","description":"Optional description of the sample to add."},"start_seconds":{"type":"number","minimum":0,"description":"Start of the sample range in seconds."},"end_seconds":{"type":"number","minimum":0,"description":"End of the sample range in seconds; must exceed start_seconds."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."}},"additionalProperties":false,"required":["model","audio_url","start_seconds","end_seconds"]},{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"suno-v4.5"},"audio_url":{"type":"string","description":"URL of the audio file to sample."},"prompt":{"type":"string","description":"Optional description of the sample to add."},"start_seconds":{"type":"number","minimum":0,"description":"Start of the sample range in seconds."},"end_seconds":{"type":"number","minimum":0,"description":"End of the sample range in seconds; must exceed start_seconds."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."}},"additionalProperties":false,"required":["model","audio_url","start_seconds","end_seconds"]},{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"suno-v4.5-plus"},"audio_url":{"type":"string","description":"URL of the audio file to sample."},"prompt":{"type":"string","description":"Optional description of the sample to add."},"start_seconds":{"type":"number","minimum":0,"description":"Start of the sample range in seconds."},"end_seconds":{"type":"number","minimum":0,"description":"End of the sample range in seconds; must exceed start_seconds."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."}},"additionalProperties":false,"required":["model","audio_url","start_seconds","end_seconds"]},{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"suno-v5"},"audio_url":{"type":"string","description":"URL of the audio file to sample."},"prompt":{"type":"string","description":"Optional description of the sample to add."},"start_seconds":{"type":"number","minimum":0,"description":"Start of the sample range in seconds."},"end_seconds":{"type":"number","minimum":0,"description":"End of the sample range in seconds; must exceed start_seconds."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."}},"additionalProperties":false,"required":["model","audio_url","start_seconds","end_seconds"]},{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"suno-v5.5"},"audio_url":{"type":"string","description":"URL of the audio file to sample."},"prompt":{"type":"string","description":"Optional description of the sample to add."},"start_seconds":{"type":"number","minimum":0,"description":"Start of the sample range in seconds."},"end_seconds":{"type":"number","minimum":0,"description":"End of the sample range in seconds; must exceed start_seconds."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."}},"additionalProperties":false,"required":["model","audio_url","start_seconds","end_seconds"]}]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/music_from_sample/{id}":{"get":{"tags":["Suno"],"summary":"Retrieve Suno Music-From-Sample task","description":"Create an asynchronous task through the Suno music from sample endpoint.","operationId":"task_endpoint_suno_music_from_sample_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"generation_stage":{"type":"string","enum":["text_generated","first_audio_ready"]},"audios":{"type":"array","items":{"type":"object","required":["id"],"properties":{"id":{"type":"string"},"audio_url":{"type":"string","x-runapi-generated-media":true},"stream_audio_url":{"type":"string","x-runapi-generated-media":true},"image_url":{"type":"string","x-runapi-generated-media":true},"lyrics":{"type":"string"},"model_name":{"type":"string"},"title":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"duration":{"type":"number"}},"unevaluatedProperties":false}}},"unevaluatedProperties":false},{"type":"object","required":["id","status","audios","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"generation_stage":{"type":"string","enum":["text_generated","first_audio_ready","all_audios_ready","failed"]},"audios":{"type":"array","items":{"type":"object","required":["id"],"properties":{"id":{"type":"string"},"audio_url":{"type":"string","x-runapi-generated-media":true},"stream_audio_url":{"type":"string","x-runapi-generated-media":true},"image_url":{"type":"string","x-runapi-generated-media":true},"lyrics":{"type":"string"},"model_name":{"type":"string"},"title":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"duration":{"type":"number"}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/music_visualizations":{"post":{"tags":["Suno"],"summary":"Suno Music-Visualizations","description":"Create an asynchronous task through the Suno music visualizations endpoint.","operationId":"task_endpoint_suno_music_visualizations","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"source_audio_id":{"type":"string","description":"Audio id within the source Task, or a RunAPI audio resource id returned by a previous request."},"source_task_id":{"type":"string","description":"RunAPI Task id that produced the audio. Required when the audio id alone does not identify the source."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."},"author":{"type":"string","description":"Author name shown in the video."},"domain_name":{"type":"string","description":"Domain name watermark."}},"additionalProperties":false,"required":["source_audio_id"]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/music_visualizations/{id}":{"get":{"tags":["Suno"],"summary":"Retrieve Suno Music-Visualizations task","description":"Create an asynchronous task through the Suno music visualizations endpoint.","operationId":"task_endpoint_suno_music_visualizations_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"video_url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false},{"type":"object","required":["id","status","video_url","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"video_url":{"type":"string","x-runapi-generated-media":true},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/nano_banana/edit_image":{"post":{"tags":["Nano Banana"],"summary":"Nano Banana Edit-Image","description":"Create an asynchronous task through the Nano Banana edit image endpoint.","operationId":"task_endpoint_nano_banana_edit_image","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"model":{"type":"string","const":"nano-banana-2-lite"},"prompt":{"type":"string","maxLength":20000,"minLength":1},"callback_url":{"type":"string"},"aspect_ratio":{"type":"string","enum":["1:1","1:4","1:8","2:3","3:2","3:4","4:1","4:3","4:5","5:4","8:1","9:16","16:9","21:9","auto"],"default":"auto"},"source_image_urls":{"type":"array","maxItems":10,"minItems":1}},"additionalProperties":false,"required":["prompt","aspect_ratio","source_image_urls","model"],"allOf":[{"if":{"properties":{"model":{"const":"nano-banana-2-lite"}},"required":["model"]},"then":{"not":{"required":["output_format"]}}}]},{"type":"object","properties":{"model":{"type":"string","const":"nano-banana-edit"},"prompt":{"type":"string"},"callback_url":{"type":"string"},"output_format":{"type":"string","enum":["png","jpeg"]},"aspect_ratio":{"type":"string","enum":["1:1","9:16","16:9","3:4","4:3","3:2","2:3","5:4","4:5","21:9","auto"]},"source_image_urls":{"type":"array"}},"additionalProperties":false,"required":["source_image_urls","model"],"allOf":[{"if":{"properties":{"model":{"const":"nano-banana-2-lite"}},"required":["model"]},"then":{"not":{"required":["output_format"]}}}]}]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/nano_banana/edit_image/{id}":{"get":{"tags":["Nano Banana"],"summary":"Retrieve Nano Banana Edit-Image task","description":"Create an asynchronous task through the Nano Banana edit image endpoint.","operationId":"task_endpoint_nano_banana_edit_image_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","images","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"images":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/nano_banana/text_to_image":{"post":{"tags":["Nano Banana"],"summary":"Nano Banana Text-to-Image","description":"Create an asynchronous task through the Nano Banana text to image endpoint.","operationId":"task_endpoint_nano_banana_text_to_image","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"model":{"type":"string","const":"nano-banana"},"prompt":{"type":"string"},"callback_url":{"type":"string"},"output_format":{"type":"string","enum":["png","jpeg","jpg"]},"aspect_ratio":{"type":"string","enum":["1:1","9:16","16:9","3:4","4:3","3:2","2:3","5:4","4:5","21:9","auto"]},"output_resolution":{"type":"string"},"reference_image_urls":{"type":"array"}},"additionalProperties":false,"required":["model"],"allOf":[{"if":{"properties":{"model":{"const":"nano-banana-2-lite"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["output_format"]}}]}}]},{"type":"object","properties":{"model":{"type":"string","const":"nano-banana-2"},"prompt":{"type":"string"},"callback_url":{"type":"string"},"output_format":{"type":"string","enum":["png","jpeg","jpg"]},"aspect_ratio":{"type":"string","enum":["1:1","1:4","1:8","2:3","3:2","3:4","4:1","4:3","4:5","5:4","8:1","9:16","16:9","21:9","auto"]},"output_resolution":{"type":"string","enum":["1k","2k","4k"],"default":"1k"},"reference_image_urls":{"type":"array"}},"additionalProperties":false,"required":["model"],"allOf":[{"if":{"properties":{"model":{"const":"nano-banana-2-lite"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["output_format"]}}]}}]},{"type":"object","properties":{"model":{"type":"string","const":"nano-banana-2-lite"},"prompt":{"type":"string","maxLength":20000,"minLength":1},"callback_url":{"type":"string"},"aspect_ratio":{"type":"string","enum":["1:1","1:4","1:8","2:3","3:2","3:4","4:1","4:3","4:5","5:4","8:1","9:16","16:9","21:9","auto"],"default":"auto"},"reference_image_urls":{"type":"array","maxItems":10}},"additionalProperties":false,"required":["prompt","aspect_ratio","model"],"allOf":[{"if":{"properties":{"model":{"const":"nano-banana-2-lite"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["output_format"]}}]}}]},{"type":"object","properties":{"model":{"type":"string","const":"nano-banana-pro"},"prompt":{"type":"string"},"callback_url":{"type":"string"},"output_format":{"type":"string","enum":["png","jpeg","jpg"]},"aspect_ratio":{"type":"string","enum":["1:1","2:3","3:2","3:4","4:3","4:5","5:4","9:16","16:9","21:9","auto"]},"output_resolution":{"type":"string","enum":["1k","2k","4k"],"default":"1k"},"reference_image_urls":{"type":"array","maxItems":8}},"additionalProperties":false,"required":["model"],"allOf":[{"if":{"properties":{"model":{"const":"nano-banana-2-lite"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["output_format"]}}]}}]}]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/nano_banana/text_to_image/{id}":{"get":{"tags":["Nano Banana"],"summary":"Retrieve Nano Banana Text-to-Image task","description":"Create an asynchronous task through the Nano Banana text to image endpoint.","operationId":"task_endpoint_nano_banana_text_to_image_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","images","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"images":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/omnihuman/audio_to_video":{"post":{"tags":["OmniHuman"],"summary":"OmniHuman Audio-to-Video","description":"Create an asynchronous task through the OmniHuman audio to video endpoint.","operationId":"task_endpoint_omnihuman_audio_to_video","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"model":{"type":"string","const":"omnihuman-1.5"},"source_image_url":{"type":"string"},"source_audio_url":{"type":"string"},"mask_urls":{"type":"array","maxItems":5},"prompt":{"type":"string","maxLength":300},"callback_url":{"type":"string"},"output_resolution":{"type":"string","enum":["720p","1080p"],"default":"1080p"},"enable_fast_mode":{"type":"boolean"},"seed":{"type":"integer"}},"additionalProperties":false,"required":["source_image_url","source_audio_url","model"]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/omnihuman/audio_to_video/{id}":{"get":{"tags":["OmniHuman"],"summary":"Retrieve OmniHuman Audio-to-Video task","description":"Create an asynchronous task through the OmniHuman audio to video endpoint.","operationId":"task_endpoint_omnihuman_audio_to_video_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","videos","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"videos":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/omnihuman/human_identification":{"post":{"tags":["OmniHuman"],"summary":"OmniHuman Human-Identification","description":"Create an asynchronous task through the OmniHuman human identification endpoint.","operationId":"task_endpoint_omnihuman_human_identification","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"model":{"type":"string","const":"omnihuman-1.5-human-identification"},"source_image_url":{"type":"string"},"callback_url":{"type":"string"}},"additionalProperties":false,"required":["source_image_url","model"]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/omnihuman/human_identification/{id}":{"get":{"tags":["OmniHuman"],"summary":"Retrieve OmniHuman Human-Identification task","description":"Create an asynchronous task through the OmniHuman human identification endpoint.","operationId":"task_endpoint_omnihuman_human_identification_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","subject_status","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"subject_status":{"type":"integer"},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/omnihuman/subject_detection":{"post":{"tags":["OmniHuman"],"summary":"OmniHuman Subject-Detection","description":"Create an asynchronous task through the OmniHuman subject detection endpoint.","operationId":"task_endpoint_omnihuman_subject_detection","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"model":{"type":"string","const":"omnihuman-1.5-subject-detection"},"source_image_url":{"type":"string"},"callback_url":{"type":"string"}},"additionalProperties":false,"required":["source_image_url","model"]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/omnihuman/subject_detection/{id}":{"get":{"tags":["OmniHuman"],"summary":"Retrieve OmniHuman Subject-Detection task","description":"Create an asynchronous task through the OmniHuman subject detection endpoint.","operationId":"task_endpoint_omnihuman_subject_detection_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","masks","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"masks":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/openai_tts/text_to_speech":{"post":{"tags":["OpenAI TTS"],"summary":"OpenAI TTS Text-to-Speech","description":"Send a synchronous request through the OpenAI TTS text to speech endpoint.","operationId":"task_endpoint_openai_tts_text_to_speech","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"tts-1"},"text":{"type":"string","maxLength":4096}},"additionalProperties":false,"required":["model","text"]},{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"tts-1-hd"},"text":{"type":"string","maxLength":4096}},"additionalProperties":false,"required":["model","text"]}]}}}},"responses":{"200":{"description":"Sync success","content":{"application/json":{"schema":{"type":"object","required":["id","status","audios"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"audios":{"type":"array","items":{"type":"object","required":["url","format","mime_type","size_bytes"],"properties":{"url":{"type":"string","x-runapi-generated-media":true},"format":{"type":"string"},"mime_type":{"type":"string"},"size_bytes":{"type":"integer"}},"unevaluatedProperties":false}}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/personas":{"post":{"tags":["Suno"],"summary":"Suno Personas","description":"Send a synchronous request through the Suno personas endpoint.","operationId":"task_endpoint_suno_personas","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"source_task_id":{"type":"string","description":"RunAPI Task id that produced the reference audio."},"source_audio_id":{"type":"string","description":"Audio id within the source Task that carries the reference vocals."},"name":{"type":"string","description":"Persona name."},"description":{"type":"string","description":"Persona description."}},"additionalProperties":false,"required":["source_task_id","source_audio_id","name","description"]}}}},"responses":{"200":{"description":"Sync success","content":{"application/json":{"schema":{"type":"object","required":["persona"],"properties":{"persona":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"}},"unevaluatedProperties":false}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/pixverse/edit_video":{"post":{"tags":["PixVerse"],"summary":"PixVerse Edit-Video","description":"Create an asynchronous task through the PixVerse edit video endpoint.","operationId":"task_endpoint_pixverse_edit_video","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"pixverse-v6"},"prompt":{"type":"string","maxLength":5000,"minLength":3,"description":"Video description."},"output_resolution":{"type":"string","enum":["360p","540p","720p","1080p"],"default":"720p","description":"Output resolution."},"duration_seconds":{"type":"integer","maximum":15,"minimum":1,"default":5,"description":"Duration in seconds."},"enable_audio":{"type":"boolean","enum":[true,false],"default":false,"description":"Enable synchronized audio generation."},"seed":{"type":"integer","maximum":2147483647,"minimum":0,"description":"Random seed."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."},"reference_image_urls":{"type":"array","items":{"type":"string"},"maxItems":7,"minItems":1,"description":"Ordered public reference image URLs."},"aspect_ratio":{"type":"string","enum":["16:9","4:3","1:1","3:4","9:16","2:3","3:2","21:9"],"default":"16:9","description":"Output aspect ratio."}},"additionalProperties":false,"required":["model","prompt","output_resolution","duration_seconds","reference_image_urls","aspect_ratio"]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/pixverse/edit_video/{id}":{"get":{"tags":["PixVerse"],"summary":"Retrieve PixVerse Edit-Video task","description":"Create an asynchronous task through the PixVerse edit video endpoint.","operationId":"task_endpoint_pixverse_edit_video_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","videos","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"videos":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/pixverse/extend_video":{"post":{"tags":["PixVerse"],"summary":"PixVerse Extend-Video","description":"Create an asynchronous task through the PixVerse extend video endpoint.","operationId":"task_endpoint_pixverse_extend_video","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"pixverse-v6"},"prompt":{"type":"string","maxLength":5000,"minLength":3,"description":"Video continuation description."},"output_resolution":{"type":"string","enum":["360p","540p","720p","1080p"],"default":"720p","description":"Output resolution."},"duration_seconds":{"type":"integer","maximum":15,"minimum":1,"default":5,"description":"Duration in seconds."},"enable_audio":{"type":"boolean","enum":[true,false],"default":false,"description":"Enable synchronized audio generation."},"seed":{"type":"integer","maximum":2147483647,"minimum":0,"description":"Random seed."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."},"source_task_id":{"type":"string","description":"Completed PixVerse video task ID to extend."}},"additionalProperties":false,"required":["model","prompt","output_resolution","duration_seconds","source_task_id"]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/pixverse/extend_video/{id}":{"get":{"tags":["PixVerse"],"summary":"Retrieve PixVerse Extend-Video task","description":"Create an asynchronous task through the PixVerse extend video endpoint.","operationId":"task_endpoint_pixverse_extend_video_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","videos","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"videos":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/pixverse/image_to_video":{"post":{"tags":["PixVerse"],"summary":"PixVerse Image-to-Video","description":"Create an asynchronous task through the PixVerse image to video endpoint.","operationId":"task_endpoint_pixverse_image_to_video","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"pixverse-v6"},"prompt":{"type":"string","maxLength":5000,"minLength":3,"description":"Video description."},"output_resolution":{"type":"string","enum":["360p","540p","720p","1080p"],"default":"720p","description":"Output resolution."},"duration_seconds":{"type":"integer","maximum":15,"minimum":1,"default":5,"description":"Duration in seconds."},"enable_audio":{"type":"boolean","enum":[true,false],"default":false,"description":"Enable synchronized audio generation."},"seed":{"type":"integer","maximum":2147483647,"minimum":0,"description":"Random seed."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."},"first_frame_image_url":{"type":"string","description":"First frame image URL."},"enable_multi_clip":{"type":"boolean","default":false,"description":"Enable multi-clip generation."}},"additionalProperties":false,"required":["model","prompt","output_resolution","duration_seconds","first_frame_image_url"]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/pixverse/image_to_video/{id}":{"get":{"tags":["PixVerse"],"summary":"Retrieve PixVerse Image-to-Video task","description":"Create an asynchronous task through the PixVerse image to video endpoint.","operationId":"task_endpoint_pixverse_image_to_video_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","videos","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"videos":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/pixverse/text_to_video":{"post":{"tags":["PixVerse"],"summary":"PixVerse Text-to-Video","description":"Create an asynchronous task through the PixVerse text to video endpoint.","operationId":"task_endpoint_pixverse_text_to_video","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"pixverse-v6"},"prompt":{"type":"string","maxLength":5000,"minLength":3,"description":"Video description."},"output_resolution":{"type":"string","enum":["360p","540p","720p","1080p"],"default":"720p","description":"Output resolution."},"duration_seconds":{"type":"integer","maximum":15,"minimum":1,"default":5,"description":"Duration in seconds."},"enable_audio":{"type":"boolean","enum":[true,false],"default":false,"description":"Enable synchronized audio generation."},"seed":{"type":"integer","maximum":2147483647,"minimum":0,"description":"Random seed."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."},"aspect_ratio":{"type":"string","enum":["16:9","4:3","1:1","3:4","9:16","2:3","3:2","21:9"],"default":"16:9","description":"Output aspect ratio."},"enable_multi_clip":{"type":"boolean","default":false,"description":"Enable multi-clip generation."}},"additionalProperties":false,"required":["model","prompt","output_resolution","duration_seconds","aspect_ratio"]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/pixverse/text_to_video/{id}":{"get":{"tags":["PixVerse"],"summary":"Retrieve PixVerse Text-to-Video task","description":"Create an asynchronous task through the PixVerse text to video endpoint.","operationId":"task_endpoint_pixverse_text_to_video_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","videos","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"videos":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/pixverse/transition_video":{"post":{"tags":["PixVerse"],"summary":"PixVerse Transition-Video","description":"Create an asynchronous task through the PixVerse transition video endpoint.","operationId":"task_endpoint_pixverse_transition_video","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"pixverse-v6"},"prompt":{"type":"string","maxLength":5000,"minLength":3,"description":"Video description."},"output_resolution":{"type":"string","enum":["360p","540p","720p","1080p"],"default":"720p","description":"Output resolution."},"duration_seconds":{"type":"integer","maximum":15,"minimum":1,"default":5,"description":"Duration in seconds."},"enable_audio":{"type":"boolean","enum":[true,false],"default":false,"description":"Enable synchronized audio generation."},"seed":{"type":"integer","maximum":2147483647,"minimum":0,"description":"Random seed."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."},"first_frame_image_url":{"type":"string","description":"First frame image URL."},"last_frame_image_url":{"type":"string","description":"Last frame image URL."}},"additionalProperties":false,"required":["model","prompt","output_resolution","duration_seconds","first_frame_image_url","last_frame_image_url"]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/pixverse/transition_video/{id}":{"get":{"tags":["PixVerse"],"summary":"Retrieve PixVerse Transition-Video task","description":"Create an asynchronous task through the PixVerse transition video endpoint.","operationId":"task_endpoint_pixverse_transition_video_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","videos","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"videos":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/producer/text_to_music":{"post":{"tags":["Producer"],"summary":"Producer Text-to-Music","description":"Create an asynchronous task through the Producer text to music endpoint.","operationId":"task_endpoint_producer_text_to_music","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"fuzz-0.8"},"vocal_mode":{"type":"string","enum":["exact_lyrics","instrumental"],"description":"Vocal generation mode."},"prompt":{"type":"string","maxLength":200,"minLength":1,"description":"Music style and production brief."},"lyrics":{"type":"string","description":"Exact lyrics to sing."},"title":{"type":"string","description":"Music title."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."}},"additionalProperties":false,"required":["model","vocal_mode","prompt"],"allOf":[{"if":{"properties":{"vocal_mode":{"const":"exact_lyrics"}},"required":["vocal_mode"]},"then":{"required":["lyrics"]}},{"if":{"properties":{"vocal_mode":{"const":"instrumental"}},"required":["vocal_mode"]},"then":{"not":{"required":["lyrics"]}}}]},{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"fuzz-1.0"},"vocal_mode":{"type":"string","enum":["exact_lyrics","instrumental"],"description":"Vocal generation mode."},"prompt":{"type":"string","maxLength":200,"minLength":1,"description":"Music style and production brief."},"lyrics":{"type":"string","description":"Exact lyrics to sing."},"title":{"type":"string","description":"Music title."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."}},"additionalProperties":false,"required":["model","vocal_mode","prompt"],"allOf":[{"if":{"properties":{"vocal_mode":{"const":"exact_lyrics"}},"required":["vocal_mode"]},"then":{"required":["lyrics"]}},{"if":{"properties":{"vocal_mode":{"const":"instrumental"}},"required":["vocal_mode"]},"then":{"not":{"required":["lyrics"]}}}]},{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"fuzz-1.0-pro"},"vocal_mode":{"type":"string","enum":["exact_lyrics","instrumental"],"description":"Vocal generation mode."},"prompt":{"type":"string","maxLength":200,"minLength":1,"description":"Music style and production brief."},"lyrics":{"type":"string","description":"Exact lyrics to sing."},"title":{"type":"string","description":"Music title."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."}},"additionalProperties":false,"required":["model","vocal_mode","prompt"],"allOf":[{"if":{"properties":{"vocal_mode":{"const":"exact_lyrics"}},"required":["vocal_mode"]},"then":{"required":["lyrics"]}},{"if":{"properties":{"vocal_mode":{"const":"instrumental"}},"required":["vocal_mode"]},"then":{"not":{"required":["lyrics"]}}}]},{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"fuzz-1.1"},"vocal_mode":{"type":"string","enum":["exact_lyrics","instrumental"],"description":"Vocal generation mode."},"prompt":{"type":"string","maxLength":200,"minLength":1,"description":"Music style and production brief."},"lyrics":{"type":"string","description":"Exact lyrics to sing."},"title":{"type":"string","description":"Music title."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."}},"additionalProperties":false,"required":["model","vocal_mode","prompt"],"allOf":[{"if":{"properties":{"vocal_mode":{"const":"exact_lyrics"}},"required":["vocal_mode"]},"then":{"required":["lyrics"]}},{"if":{"properties":{"vocal_mode":{"const":"instrumental"}},"required":["vocal_mode"]},"then":{"not":{"required":["lyrics"]}}}]},{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"fuzz-1.1-pro"},"vocal_mode":{"type":"string","enum":["exact_lyrics","instrumental"],"description":"Vocal generation mode."},"prompt":{"type":"string","maxLength":200,"minLength":1,"description":"Music style and production brief."},"lyrics":{"type":"string","description":"Exact lyrics to sing."},"title":{"type":"string","description":"Music title."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."}},"additionalProperties":false,"required":["model","vocal_mode","prompt"],"allOf":[{"if":{"properties":{"vocal_mode":{"const":"exact_lyrics"}},"required":["vocal_mode"]},"then":{"required":["lyrics"]}},{"if":{"properties":{"vocal_mode":{"const":"instrumental"}},"required":["vocal_mode"]},"then":{"not":{"required":["lyrics"]}}}]},{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"fuzz-2.0"},"vocal_mode":{"type":"string","enum":["exact_lyrics","instrumental"],"description":"Vocal generation mode."},"prompt":{"type":"string","maxLength":200,"minLength":1,"description":"Music style and production brief."},"lyrics":{"type":"string","description":"Exact lyrics to sing."},"title":{"type":"string","description":"Music title."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."}},"additionalProperties":false,"required":["model","vocal_mode","prompt"],"allOf":[{"if":{"properties":{"vocal_mode":{"const":"exact_lyrics"}},"required":["vocal_mode"]},"then":{"required":["lyrics"]}},{"if":{"properties":{"vocal_mode":{"const":"instrumental"}},"required":["vocal_mode"]},"then":{"not":{"required":["lyrics"]}}}]},{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"fuzz-2.0-pro"},"vocal_mode":{"type":"string","enum":["exact_lyrics","instrumental"],"description":"Vocal generation mode."},"prompt":{"type":"string","maxLength":200,"minLength":1,"description":"Music style and production brief."},"lyrics":{"type":"string","description":"Exact lyrics to sing."},"title":{"type":"string","description":"Music title."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."}},"additionalProperties":false,"required":["model","vocal_mode","prompt"],"allOf":[{"if":{"properties":{"vocal_mode":{"const":"exact_lyrics"}},"required":["vocal_mode"]},"then":{"required":["lyrics"]}},{"if":{"properties":{"vocal_mode":{"const":"instrumental"}},"required":["vocal_mode"]},"then":{"not":{"required":["lyrics"]}}}]},{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"fuzz-2.0-raw"},"vocal_mode":{"type":"string","enum":["exact_lyrics","instrumental"],"description":"Vocal generation mode."},"prompt":{"type":"string","maxLength":200,"minLength":1,"description":"Music style and production brief."},"lyrics":{"type":"string","description":"Exact lyrics to sing."},"title":{"type":"string","description":"Music title."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."}},"additionalProperties":false,"required":["model","vocal_mode","prompt"],"allOf":[{"if":{"properties":{"vocal_mode":{"const":"exact_lyrics"}},"required":["vocal_mode"]},"then":{"required":["lyrics"]}},{"if":{"properties":{"vocal_mode":{"const":"instrumental"}},"required":["vocal_mode"]},"then":{"not":{"required":["lyrics"]}}}]}]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/producer/text_to_music/{id}":{"get":{"tags":["Producer"],"summary":"Retrieve Producer Text-to-Music task","description":"Create an asynchronous task through the Producer text to music endpoint.","operationId":"task_endpoint_producer_text_to_music_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","generation_stage","audios","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"generation_stage":{"type":"string","enum":["all_audios_ready"]},"audios":{"type":"array","items":{"type":"object","required":["id","audio_url","model_name"],"properties":{"id":{"type":"string"},"audio_url":{"type":"string","x-runapi-generated-media":true},"image_url":{"type":"string","x-runapi-generated-media":true},"model_name":{"type":"string"},"title":{"type":"string"},"duration_seconds":{"type":"number"},"lyrics":{"type":"string"}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error","generation_stage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"},"generation_stage":{"type":"string","enum":["failed"]}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/qwen_2/edit_image":{"post":{"tags":["Qwen 2"],"summary":"Qwen 2 Edit-Image","description":"Create an asynchronous task through the Qwen 2 edit image endpoint.","operationId":"task_endpoint_qwen_2_edit_image","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"model":{"type":"string","const":"qwen-2-edit-image"},"prompt":{"type":"string"},"source_image_url":{"type":"string"},"aspect_ratio":{"type":"string","enum":["1:1","2:3","3:2","3:4","4:3","9:16","16:9","21:9"]},"output_format":{"type":"string","enum":["jpeg","png"]},"seed":{"type":"integer"},"enable_safety_checker":{"type":"boolean"},"callback_url":{"type":"string"}},"additionalProperties":false,"required":["prompt","source_image_url","model"]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/qwen_2/edit_image/{id}":{"get":{"tags":["Qwen 2"],"summary":"Retrieve Qwen 2 Edit-Image task","description":"Create an asynchronous task through the Qwen 2 edit image endpoint.","operationId":"task_endpoint_qwen_2_edit_image_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","images","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"images":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/qwen_2/text_to_image":{"post":{"tags":["Qwen 2"],"summary":"Qwen 2 Text-to-Image","description":"Create an asynchronous task through the Qwen 2 text to image endpoint.","operationId":"task_endpoint_qwen_2_text_to_image","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"model":{"type":"string","const":"qwen-2-text-to-image"},"prompt":{"type":"string"},"aspect_ratio":{"type":"string","enum":["1:1","3:4","4:3","9:16","16:9"]},"seed":{"type":"integer"},"output_format":{"type":"string","enum":["png","jpeg"]},"enable_safety_checker":{"type":"boolean"},"callback_url":{"type":"string"}},"additionalProperties":false,"required":["prompt","model"]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/qwen_2/text_to_image/{id}":{"get":{"tags":["Qwen 2"],"summary":"Retrieve Qwen 2 Text-to-Image task","description":"Create an asynchronous task through the Qwen 2 text to image endpoint.","operationId":"task_endpoint_qwen_2_text_to_image_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","images","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"images":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/qwen_3/edit_image":{"post":{"tags":["Qwen 3"],"summary":"Qwen 3 Edit-Image","description":"Create an asynchronous task through the Qwen 3 edit image endpoint.","operationId":"task_endpoint_qwen_3_edit_image","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"model":{"type":"string","description":"RunAPI model identifier.","const":"qwen-3-edit-image"},"prompt":{"type":"string","maxLength":800,"minLength":1,"description":"Image editing prompt."},"source_image_urls":{"type":"array","items":{"type":"string"},"maxItems":3,"minItems":1,"description":"Public source image URLs; one to three images."},"output_resolution":{"type":"string","enum":["1k","2k"],"default":"1k","description":"Output image resolution."},"aspect_ratio":{"type":"string","enum":["1:1","3:2","2:3","4:3","3:4","16:9","9:16","21:9"],"default":"16:9","description":"Output aspect ratio."},"output_format":{"type":"string","enum":["png","jpeg"],"default":"png","description":"Output image format."},"enable_prompt_expansion":{"type":"boolean","default":true,"description":"Whether RunAPI expands the prompt before generation."},"enable_safety_checker":{"type":"boolean","default":false,"description":"Whether RunAPI checks generated content for safety."},"negative_prompt":{"type":"string","maxLength":5000,"minLength":0,"description":"Content to avoid in the generated image."},"seed":{"type":"integer","maximum":2147483647,"minimum":0,"default":1,"description":"Integer seed for reproducible results."},"callback_url":{"type":"string","description":"Webhook URL for asynchronous task updates."}},"additionalProperties":false,"required":["model","prompt","source_image_urls"]},{"type":"object","properties":{"model":{"type":"string","description":"RunAPI model identifier.","const":"qwen-3-pro-edit-image"},"prompt":{"type":"string","maxLength":800,"minLength":1,"description":"Image editing prompt."},"source_image_urls":{"type":"array","items":{"type":"string"},"maxItems":3,"minItems":1,"description":"Public source image URLs; one to three images."},"output_resolution":{"type":"string","enum":["1k","2k"],"default":"1k","description":"Output image resolution."},"aspect_ratio":{"type":"string","enum":["1:1","3:2","2:3","4:3","3:4","16:9","9:16","21:9"],"default":"16:9","description":"Output aspect ratio."},"output_format":{"type":"string","enum":["png","jpeg"],"default":"png","description":"Output image format."},"enable_prompt_expansion":{"type":"boolean","default":true,"description":"Whether RunAPI expands the prompt before generation."},"enable_safety_checker":{"type":"boolean","default":false,"description":"Whether RunAPI checks generated content for safety."},"negative_prompt":{"type":"string","maxLength":5000,"minLength":0,"description":"Content to avoid in the generated image."},"seed":{"type":"integer","maximum":2147483647,"minimum":0,"default":1,"description":"Integer seed for reproducible results."},"callback_url":{"type":"string","description":"Webhook URL for asynchronous task updates."}},"additionalProperties":false,"required":["model","prompt","source_image_urls"]}]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/qwen_3/edit_image/{id}":{"get":{"tags":["Qwen 3"],"summary":"Retrieve Qwen 3 Edit-Image task","description":"Create an asynchronous task through the Qwen 3 edit image endpoint.","operationId":"task_endpoint_qwen_3_edit_image_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","images","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"images":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/qwen_3/text_to_image":{"post":{"tags":["Qwen 3"],"summary":"Qwen 3 Text-to-Image","description":"Create an asynchronous task through the Qwen 3 text to image endpoint.","operationId":"task_endpoint_qwen_3_text_to_image","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"model":{"type":"string","description":"RunAPI model identifier.","const":"qwen-3-pro-text-to-image"},"prompt":{"type":"string","maxLength":800,"minLength":1,"description":"Image generation prompt."},"output_resolution":{"type":"string","enum":["1k","2k"],"default":"1k","description":"Output image resolution."},"aspect_ratio":{"type":"string","enum":["1:1","3:2","2:3","4:3","3:4","16:9","9:16","21:9"],"default":"16:9","description":"Output aspect ratio."},"output_format":{"type":"string","enum":["png","jpeg"],"default":"png","description":"Output image format."},"enable_prompt_expansion":{"type":"boolean","default":true,"description":"Whether RunAPI expands the prompt before generation."},"enable_safety_checker":{"type":"boolean","default":false,"description":"Whether RunAPI checks generated content for safety."},"negative_prompt":{"type":"string","maxLength":5000,"minLength":0,"description":"Content to avoid in the generated image."},"seed":{"type":"integer","maximum":2147483647,"minimum":0,"default":1,"description":"Integer seed for reproducible results."},"callback_url":{"type":"string","description":"Webhook URL for asynchronous task updates."}},"additionalProperties":false,"required":["model","prompt"]},{"type":"object","properties":{"model":{"type":"string","description":"RunAPI model identifier.","const":"qwen-3-text-to-image"},"prompt":{"type":"string","maxLength":800,"minLength":1,"description":"Image generation prompt."},"output_resolution":{"type":"string","enum":["1k","2k"],"default":"1k","description":"Output image resolution."},"aspect_ratio":{"type":"string","enum":["1:1","3:2","2:3","4:3","3:4","16:9","9:16","21:9"],"default":"16:9","description":"Output aspect ratio."},"output_format":{"type":"string","enum":["png","jpeg"],"default":"png","description":"Output image format."},"enable_prompt_expansion":{"type":"boolean","default":true,"description":"Whether RunAPI expands the prompt before generation."},"enable_safety_checker":{"type":"boolean","default":false,"description":"Whether RunAPI checks generated content for safety."},"negative_prompt":{"type":"string","maxLength":5000,"minLength":0,"description":"Content to avoid in the generated image."},"seed":{"type":"integer","maximum":2147483647,"minimum":0,"default":1,"description":"Integer seed for reproducible results."},"callback_url":{"type":"string","description":"Webhook URL for asynchronous task updates."}},"additionalProperties":false,"required":["model","prompt"]}]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/qwen_3/text_to_image/{id}":{"get":{"tags":["Qwen 3"],"summary":"Retrieve Qwen 3 Text-to-Image task","description":"Create an asynchronous task through the Qwen 3 text to image endpoint.","operationId":"task_endpoint_qwen_3_text_to_image_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","images","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"images":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/qwen_image/edit_image":{"post":{"tags":["Qwen Image"],"summary":"Qwen Image Edit-Image","description":"Create an asynchronous task through the Qwen Image edit image endpoint.","operationId":"task_endpoint_qwen_image_edit_image","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"model":{"type":"string","description":"RunAPI model identifier.","const":"qwen-image-edit-image"},"prompt":{"type":"string","maxLength":2000,"minLength":1,"description":"Edit instruction for the source image."},"source_image_url":{"type":"string","description":"Public HTTPS source image URL (JPEG, PNG, or WebP; maximum 10 MB)."},"aspect_ratio":{"type":"string","enum":["1:1","3:4","9:16","4:3","16:9"],"default":"1:1","description":"Output aspect ratio."},"output_format":{"type":"string","enum":["png","jpeg"],"default":"png","description":"Output image format."},"seed":{"type":"integer","description":"Integer seed for reproducible results."},"callback_url":{"type":"string","description":"Webhook URL for asynchronous task updates."}},"additionalProperties":false,"required":["model","prompt","source_image_url"]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/qwen_image/edit_image/{id}":{"get":{"tags":["Qwen Image"],"summary":"Retrieve Qwen Image Edit-Image task","description":"Create an asynchronous task through the Qwen Image edit image endpoint.","operationId":"task_endpoint_qwen_image_edit_image_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","images","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"images":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/qwen_image/remix_image":{"post":{"tags":["Qwen Image"],"summary":"Qwen Image Remix-Image","description":"Create an asynchronous task through the Qwen Image remix image endpoint.","operationId":"task_endpoint_qwen_image_remix_image","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"model":{"type":"string","description":"RunAPI model identifier.","const":"qwen-image-remix-image"},"prompt":{"type":"string","maxLength":5000,"minLength":1,"description":"Prompt describing the requested remix."},"source_image_url":{"type":"string","description":"Public HTTPS source image URL (JPEG, PNG, or WebP; maximum 10 MB)."},"strength":{"type":"number","maximum":1,"minimum":0,"default":0.8,"description":"Creative deviation from the source image, from 0 (faithful) to 1 (creative)."},"output_format":{"type":"string","enum":["png","jpeg"],"default":"png","description":"Output image format."},"seed":{"type":"integer","description":"Integer seed for reproducible results."},"callback_url":{"type":"string","description":"Webhook URL for asynchronous task updates."}},"additionalProperties":false,"required":["model","prompt","source_image_url"]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/qwen_image/remix_image/{id}":{"get":{"tags":["Qwen Image"],"summary":"Retrieve Qwen Image Remix-Image task","description":"Create an asynchronous task through the Qwen Image remix image endpoint.","operationId":"task_endpoint_qwen_image_remix_image_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","images","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"images":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/qwen_image/text_to_image":{"post":{"tags":["Qwen Image"],"summary":"Qwen Image Text-to-Image","description":"Create an asynchronous task through the Qwen Image text to image endpoint.","operationId":"task_endpoint_qwen_image_text_to_image","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"model":{"type":"string","description":"RunAPI model identifier.","const":"qwen-image-text-to-image"},"prompt":{"type":"string","maxLength":5000,"minLength":1,"description":"Image generation prompt."},"aspect_ratio":{"type":"string","enum":["1:1","3:4","9:16","4:3","16:9"],"default":"1:1","description":"Output aspect ratio."},"seed":{"type":"integer","description":"Integer seed for reproducible results."},"output_format":{"type":"string","enum":["png","jpeg"],"default":"png","description":"Output image format."},"callback_url":{"type":"string","description":"Webhook URL for asynchronous task updates."}},"additionalProperties":false,"required":["model","prompt"]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/qwen_image/text_to_image/{id}":{"get":{"tags":["Qwen Image"],"summary":"Retrieve Qwen Image Text-to-Image task","description":"Create an asynchronous task through the Qwen Image text to image endpoint.","operationId":"task_endpoint_qwen_image_text_to_image_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","images","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"images":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/recraft/remove_background":{"post":{"tags":["Recraft"],"summary":"Recraft Remove-Background","description":"Create an asynchronous task through the Recraft remove background endpoint.","operationId":"task_endpoint_recraft_remove_background","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"model":{"type":"string","const":"recraft-remove-background"},"source_image_url":{"type":"string"},"callback_url":{"type":"string"}},"additionalProperties":false,"required":["source_image_url","model"]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/recraft/remove_background/{id}":{"get":{"tags":["Recraft"],"summary":"Retrieve Recraft Remove-Background task","description":"Create an asynchronous task through the Recraft remove background endpoint.","operationId":"task_endpoint_recraft_remove_background_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","images","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"images":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/recraft/upscale_image":{"post":{"tags":["Recraft"],"summary":"Recraft Upscale-Image","description":"Create an asynchronous task through the Recraft upscale image endpoint.","operationId":"task_endpoint_recraft_upscale_image","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"model":{"type":"string","const":"recraft-crisp-upscale"},"source_image_url":{"type":"string"},"callback_url":{"type":"string"}},"additionalProperties":false,"required":["source_image_url","model"]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/recraft/upscale_image/{id}":{"get":{"tags":["Recraft"],"summary":"Retrieve Recraft Upscale-Image task","description":"Create an asynchronous task through the Recraft upscale image endpoint.","operationId":"task_endpoint_recraft_upscale_image_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","images","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"images":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/runway/extend_video":{"post":{"tags":["Runway"],"summary":"Runway Extend-Video","description":"Create an asynchronous task through the Runway extend video endpoint.","operationId":"task_endpoint_runway_extend_video","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"model":{"type":"string","const":"runway"},"source_task_id":{"type":"string"},"prompt":{"type":"string"},"output_resolution":{"type":"string","enum":["720p","1080p"]},"watermark":{"type":"string"},"callback_url":{"type":"string"}},"additionalProperties":false,"required":["source_task_id","prompt","output_resolution","model"]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/runway/extend_video/{id}":{"get":{"tags":["Runway"],"summary":"Retrieve Runway Extend-Video task","description":"Create an asynchronous task through the Runway extend video endpoint.","operationId":"task_endpoint_runway_extend_video_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","videos","images","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"videos":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"images":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/runway/text_to_video":{"post":{"tags":["Runway"],"summary":"Runway Text-to-Video","description":"Create an asynchronous task through the Runway text to video endpoint.","operationId":"task_endpoint_runway_text_to_video","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"model":{"type":"string","const":"runway"},"prompt":{"type":"string"},"duration_seconds":{"type":"integer","enum":[5,10]},"output_resolution":{"type":"string","enum":["720p","1080p"]},"first_frame_image_url":{"type":"string"},"aspect_ratio":{"type":"string","enum":["16:9","9:16","1:1","4:3","3:4"]},"watermark":{"type":"string"},"callback_url":{"type":"string"}},"additionalProperties":false,"required":["prompt","duration_seconds","output_resolution","model"],"allOf":[{"if":{"not":{"required":["first_frame_image_url"]}},"then":{"required":["aspect_ratio"]}},{"if":{"required":["first_frame_image_url"]},"then":{"not":{"required":["aspect_ratio"]}}}]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/runway/text_to_video/{id}":{"get":{"tags":["Runway"],"summary":"Retrieve Runway Text-to-Video task","description":"Create an asynchronous task through the Runway text to video endpoint.","operationId":"task_endpoint_runway_text_to_video_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","videos","images","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"videos":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"images":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/runway_aleph/edit_video/{id}":{"get":{"tags":["Runway Aleph"],"summary":"Retrieve Runway Aleph Edit-Video task","description":"This endpoint is retired. New requests return HTTP 410. Existing tasks remain queryable.","operationId":"task_endpoint_runway_aleph_edit_video_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","videos","images","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"videos":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"images":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/seedance/text_to_video":{"post":{"tags":["Seedance"],"summary":"Seedance Text-to-Video","description":"Create an asynchronous task through the Seedance text to video endpoint.","operationId":"task_endpoint_seedance_text_to_video","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"prompt":{"type":"string"},"model":{"type":"string","const":"seedance-1.5-pro"},"callback_url":{"type":"string"},"aspect_ratio":{"type":"string","enum":["1:1","4:3","3:4","16:9","9:16","21:9"]},"output_resolution":{"type":"string","enum":["480p","720p","1080p"],"default":"720p"},"duration_seconds":{"type":"integer","maximum":12,"minimum":4},"generate_audio":{"type":"boolean","default":false},"enable_safety_checker":{"type":"boolean"},"source_image_urls":{"type":"array","maxItems":2},"lock_camera":{"type":"boolean"},"seed":{"type":"integer","maximum":2147483647,"minimum":-1}},"additionalProperties":false,"required":["duration_seconds","model"],"allOf":[{"if":{"allOf":[{"properties":{"model":{"const":"seedance-2.5"}},"required":["model"]},{"required":["first_frame_image_url"]}]},"then":{"allOf":[{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_urls"]}},{"not":{"required":["reference_audio_urls"]}},{"properties":{"aspect_ratio":{"enum":["auto"]}}}]}},{"if":{"allOf":[{"properties":{"model":{"const":"seedance-2.5"}},"required":["model"]},{"required":["last_frame_image_url"]}]},"then":{"allOf":[{"required":["first_frame_image_url"]},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_urls"]}},{"not":{"required":["reference_audio_urls"]}}]}},{"if":{"properties":{"model":{"const":"seedance-1.5-pro"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["first_frame_image_url"]}},{"not":{"required":["last_frame_image_url"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_urls"]}},{"not":{"required":["reference_audio_urls"]}},{"not":{"required":["web_search"]}},{"not":{"required":["return_last_frame"]}},{"not":{"required":["output_format"]}}]}},{"if":{"properties":{"model":{"const":"seedance-2-mini"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["source_image_urls"]}},{"not":{"required":["lock_camera"]}},{"not":{"required":["seed"]}},{"not":{"required":["enable_safety_checker"]}},{"not":{"required":["return_last_frame"]}},{"not":{"required":["output_format"]}}]}},{"if":{"properties":{"model":{"const":"seedance-2.0"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["source_image_urls"]}},{"not":{"required":["lock_camera"]}},{"not":{"required":["seed"]}},{"not":{"required":["return_last_frame"]}},{"not":{"required":["output_format"]}}]}},{"if":{"properties":{"model":{"const":"seedance-2.0-fast"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["source_image_urls"]}},{"not":{"required":["lock_camera"]}},{"not":{"required":["seed"]}},{"not":{"required":["return_last_frame"]}},{"not":{"required":["output_format"]}}]}},{"if":{"properties":{"model":{"const":"seedance-2.5"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["source_image_urls"]}},{"not":{"required":["lock_camera"]}},{"not":{"required":["seed"]}}]}},{"if":{"properties":{"model":{"const":"seedance-v1-pro"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["source_image_urls"]}},{"not":{"required":["last_frame_image_url"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_urls"]}},{"not":{"required":["reference_audio_urls"]}},{"not":{"required":["web_search"]}},{"not":{"required":["generate_audio"]}},{"not":{"required":["return_last_frame"]}},{"not":{"required":["output_format"]}}]}},{"if":{"properties":{"model":{"const":"seedance-v1-pro-fast"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["aspect_ratio"]}},{"not":{"required":["source_image_urls"]}},{"not":{"required":["lock_camera"]}},{"not":{"required":["last_frame_image_url"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_urls"]}},{"not":{"required":["reference_audio_urls"]}},{"not":{"required":["web_search"]}},{"not":{"required":["generate_audio"]}},{"not":{"required":["return_last_frame"]}},{"not":{"required":["output_format"]}}]}}]},{"type":"object","properties":{"prompt":{"type":"string"},"model":{"type":"string","const":"seedance-2-mini"},"callback_url":{"type":"string"},"aspect_ratio":{"type":"string","enum":["1:1","4:3","3:4","16:9","9:16","21:9","auto"],"default":"16:9"},"output_resolution":{"type":"string","enum":["480p","720p"],"default":"720p"},"duration_seconds":{"type":"integer","enum":[4,5,6,7,8,9,10,11,12,13,14,15],"default":5,"description":"Video duration in seconds."},"generate_audio":{"type":"boolean","default":true},"first_frame_image_url":{"type":"string"},"last_frame_image_url":{"type":"string"},"reference_image_urls":{"type":"array","maxItems":9},"reference_video_urls":{"type":"array","maxItems":3},"reference_audio_urls":{"type":"array","maxItems":3},"web_search":{"type":"boolean"}},"additionalProperties":false,"required":["model"],"allOf":[{"if":{"allOf":[{"properties":{"model":{"const":"seedance-2.5"}},"required":["model"]},{"required":["first_frame_image_url"]}]},"then":{"allOf":[{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_urls"]}},{"not":{"required":["reference_audio_urls"]}},{"properties":{"aspect_ratio":{"enum":["auto"]}}}]}},{"if":{"allOf":[{"properties":{"model":{"const":"seedance-2.5"}},"required":["model"]},{"required":["last_frame_image_url"]}]},"then":{"allOf":[{"required":["first_frame_image_url"]},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_urls"]}},{"not":{"required":["reference_audio_urls"]}}]}},{"if":{"properties":{"model":{"const":"seedance-1.5-pro"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["first_frame_image_url"]}},{"not":{"required":["last_frame_image_url"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_urls"]}},{"not":{"required":["reference_audio_urls"]}},{"not":{"required":["web_search"]}},{"not":{"required":["return_last_frame"]}},{"not":{"required":["output_format"]}}]}},{"if":{"properties":{"model":{"const":"seedance-2-mini"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["source_image_urls"]}},{"not":{"required":["lock_camera"]}},{"not":{"required":["seed"]}},{"not":{"required":["enable_safety_checker"]}},{"not":{"required":["return_last_frame"]}},{"not":{"required":["output_format"]}}]}},{"if":{"properties":{"model":{"const":"seedance-2.0"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["source_image_urls"]}},{"not":{"required":["lock_camera"]}},{"not":{"required":["seed"]}},{"not":{"required":["return_last_frame"]}},{"not":{"required":["output_format"]}}]}},{"if":{"properties":{"model":{"const":"seedance-2.0-fast"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["source_image_urls"]}},{"not":{"required":["lock_camera"]}},{"not":{"required":["seed"]}},{"not":{"required":["return_last_frame"]}},{"not":{"required":["output_format"]}}]}},{"if":{"properties":{"model":{"const":"seedance-2.5"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["source_image_urls"]}},{"not":{"required":["lock_camera"]}},{"not":{"required":["seed"]}}]}},{"if":{"properties":{"model":{"const":"seedance-v1-pro"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["source_image_urls"]}},{"not":{"required":["last_frame_image_url"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_urls"]}},{"not":{"required":["reference_audio_urls"]}},{"not":{"required":["web_search"]}},{"not":{"required":["generate_audio"]}},{"not":{"required":["return_last_frame"]}},{"not":{"required":["output_format"]}}]}},{"if":{"properties":{"model":{"const":"seedance-v1-pro-fast"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["aspect_ratio"]}},{"not":{"required":["source_image_urls"]}},{"not":{"required":["lock_camera"]}},{"not":{"required":["last_frame_image_url"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_urls"]}},{"not":{"required":["reference_audio_urls"]}},{"not":{"required":["web_search"]}},{"not":{"required":["generate_audio"]}},{"not":{"required":["return_last_frame"]}},{"not":{"required":["output_format"]}}]}}]},{"type":"object","properties":{"prompt":{"type":"string"},"model":{"type":"string","const":"seedance-2.0"},"callback_url":{"type":"string"},"aspect_ratio":{"type":"string","enum":["1:1","4:3","3:4","16:9","9:16","21:9","auto"],"default":"16:9"},"output_resolution":{"type":"string","enum":["480p","720p","1080p","4k"],"default":"720p"},"duration_seconds":{"type":"integer","enum":[4,5,6,7,8,9,10,11,12,13,14,15],"default":5,"description":"Video duration in seconds."},"generate_audio":{"type":"boolean","default":true},"enable_safety_checker":{"type":"boolean"},"first_frame_image_url":{"type":"string"},"last_frame_image_url":{"type":"string"},"reference_image_urls":{"type":"array","maxItems":9},"reference_video_urls":{"type":"array","maxItems":3},"reference_audio_urls":{"type":"array","maxItems":3},"web_search":{"type":"boolean"}},"additionalProperties":false,"required":["model"],"allOf":[{"if":{"allOf":[{"properties":{"model":{"const":"seedance-2.5"}},"required":["model"]},{"required":["first_frame_image_url"]}]},"then":{"allOf":[{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_urls"]}},{"not":{"required":["reference_audio_urls"]}},{"properties":{"aspect_ratio":{"enum":["auto"]}}}]}},{"if":{"allOf":[{"properties":{"model":{"const":"seedance-2.5"}},"required":["model"]},{"required":["last_frame_image_url"]}]},"then":{"allOf":[{"required":["first_frame_image_url"]},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_urls"]}},{"not":{"required":["reference_audio_urls"]}}]}},{"if":{"properties":{"model":{"const":"seedance-1.5-pro"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["first_frame_image_url"]}},{"not":{"required":["last_frame_image_url"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_urls"]}},{"not":{"required":["reference_audio_urls"]}},{"not":{"required":["web_search"]}},{"not":{"required":["return_last_frame"]}},{"not":{"required":["output_format"]}}]}},{"if":{"properties":{"model":{"const":"seedance-2-mini"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["source_image_urls"]}},{"not":{"required":["lock_camera"]}},{"not":{"required":["seed"]}},{"not":{"required":["enable_safety_checker"]}},{"not":{"required":["return_last_frame"]}},{"not":{"required":["output_format"]}}]}},{"if":{"properties":{"model":{"const":"seedance-2.0"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["source_image_urls"]}},{"not":{"required":["lock_camera"]}},{"not":{"required":["seed"]}},{"not":{"required":["return_last_frame"]}},{"not":{"required":["output_format"]}}]}},{"if":{"properties":{"model":{"const":"seedance-2.0-fast"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["source_image_urls"]}},{"not":{"required":["lock_camera"]}},{"not":{"required":["seed"]}},{"not":{"required":["return_last_frame"]}},{"not":{"required":["output_format"]}}]}},{"if":{"properties":{"model":{"const":"seedance-2.5"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["source_image_urls"]}},{"not":{"required":["lock_camera"]}},{"not":{"required":["seed"]}}]}},{"if":{"properties":{"model":{"const":"seedance-v1-pro"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["source_image_urls"]}},{"not":{"required":["last_frame_image_url"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_urls"]}},{"not":{"required":["reference_audio_urls"]}},{"not":{"required":["web_search"]}},{"not":{"required":["generate_audio"]}},{"not":{"required":["return_last_frame"]}},{"not":{"required":["output_format"]}}]}},{"if":{"properties":{"model":{"const":"seedance-v1-pro-fast"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["aspect_ratio"]}},{"not":{"required":["source_image_urls"]}},{"not":{"required":["lock_camera"]}},{"not":{"required":["last_frame_image_url"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_urls"]}},{"not":{"required":["reference_audio_urls"]}},{"not":{"required":["web_search"]}},{"not":{"required":["generate_audio"]}},{"not":{"required":["return_last_frame"]}},{"not":{"required":["output_format"]}}]}}]},{"type":"object","properties":{"prompt":{"type":"string"},"model":{"type":"string","const":"seedance-2.0-fast"},"callback_url":{"type":"string"},"aspect_ratio":{"type":"string","enum":["1:1","4:3","3:4","16:9","9:16","21:9","auto"],"default":"16:9"},"output_resolution":{"type":"string","enum":["480p","720p"],"default":"720p"},"duration_seconds":{"type":"integer","enum":[4,5,6,7,8,9,10,11,12,13,14,15],"default":5,"description":"Video duration in seconds."},"generate_audio":{"type":"boolean","default":true},"enable_safety_checker":{"type":"boolean"},"first_frame_image_url":{"type":"string"},"last_frame_image_url":{"type":"string"},"reference_image_urls":{"type":"array","maxItems":9},"reference_video_urls":{"type":"array","maxItems":3},"reference_audio_urls":{"type":"array","maxItems":3},"web_search":{"type":"boolean"}},"additionalProperties":false,"required":["model"],"allOf":[{"if":{"allOf":[{"properties":{"model":{"const":"seedance-2.5"}},"required":["model"]},{"required":["first_frame_image_url"]}]},"then":{"allOf":[{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_urls"]}},{"not":{"required":["reference_audio_urls"]}},{"properties":{"aspect_ratio":{"enum":["auto"]}}}]}},{"if":{"allOf":[{"properties":{"model":{"const":"seedance-2.5"}},"required":["model"]},{"required":["last_frame_image_url"]}]},"then":{"allOf":[{"required":["first_frame_image_url"]},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_urls"]}},{"not":{"required":["reference_audio_urls"]}}]}},{"if":{"properties":{"model":{"const":"seedance-1.5-pro"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["first_frame_image_url"]}},{"not":{"required":["last_frame_image_url"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_urls"]}},{"not":{"required":["reference_audio_urls"]}},{"not":{"required":["web_search"]}},{"not":{"required":["return_last_frame"]}},{"not":{"required":["output_format"]}}]}},{"if":{"properties":{"model":{"const":"seedance-2-mini"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["source_image_urls"]}},{"not":{"required":["lock_camera"]}},{"not":{"required":["seed"]}},{"not":{"required":["enable_safety_checker"]}},{"not":{"required":["return_last_frame"]}},{"not":{"required":["output_format"]}}]}},{"if":{"properties":{"model":{"const":"seedance-2.0"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["source_image_urls"]}},{"not":{"required":["lock_camera"]}},{"not":{"required":["seed"]}},{"not":{"required":["return_last_frame"]}},{"not":{"required":["output_format"]}}]}},{"if":{"properties":{"model":{"const":"seedance-2.0-fast"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["source_image_urls"]}},{"not":{"required":["lock_camera"]}},{"not":{"required":["seed"]}},{"not":{"required":["return_last_frame"]}},{"not":{"required":["output_format"]}}]}},{"if":{"properties":{"model":{"const":"seedance-2.5"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["source_image_urls"]}},{"not":{"required":["lock_camera"]}},{"not":{"required":["seed"]}}]}},{"if":{"properties":{"model":{"const":"seedance-v1-pro"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["source_image_urls"]}},{"not":{"required":["last_frame_image_url"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_urls"]}},{"not":{"required":["reference_audio_urls"]}},{"not":{"required":["web_search"]}},{"not":{"required":["generate_audio"]}},{"not":{"required":["return_last_frame"]}},{"not":{"required":["output_format"]}}]}},{"if":{"properties":{"model":{"const":"seedance-v1-pro-fast"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["aspect_ratio"]}},{"not":{"required":["source_image_urls"]}},{"not":{"required":["lock_camera"]}},{"not":{"required":["last_frame_image_url"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_urls"]}},{"not":{"required":["reference_audio_urls"]}},{"not":{"required":["web_search"]}},{"not":{"required":["generate_audio"]}},{"not":{"required":["return_last_frame"]}},{"not":{"required":["output_format"]}}]}}]},{"type":"object","properties":{"prompt":{"type":"string","maxLength":20480,"minLength":3,"description":"Video generation prompt."},"model":{"type":"string","description":"RunAPI model identifier.","const":"seedance-2.5"},"callback_url":{"type":"string","description":"Webhook URL for asynchronous task updates."},"aspect_ratio":{"type":"string","enum":["1:1","4:3","3:4","16:9","9:16","21:9","auto"],"default":"auto","description":"Output aspect ratio; auto lets RunAPI select it."},"output_resolution":{"type":"string","enum":["480p","720p","1080p"],"default":"720p","description":"Output video resolution."},"duration_seconds":{"type":"integer","enum":[-1,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,28,29,30],"default":5,"description":"Video duration in seconds; -1 selects duration automatically."},"generate_audio":{"type":"boolean","default":true,"description":"Whether to generate synchronized audio."},"enable_safety_checker":{"type":"boolean","description":"Whether RunAPI checks generated content for safety."},"return_last_frame":{"type":"boolean","default":false,"description":"Whether to return the generated video's last frame."},"output_format":{"type":"string","enum":["mp4","mov"],"default":"mp4","description":"Output video container format."},"first_frame_image_url":{"type":"string","description":"Public first-frame image URL for frame-guided generation."},"last_frame_image_url":{"type":"string","description":"Public last-frame image URL; requires first_frame_image_url."},"reference_image_urls":{"type":"array","items":{"type":"string"},"maxItems":30,"description":"Public reference image URLs; up to 30 images."},"reference_video_urls":{"type":"array","items":{"type":"string"},"maxItems":10,"description":"Public reference video URLs; up to 10 videos."},"reference_audio_urls":{"type":"array","items":{"type":"string"},"maxItems":10,"description":"Public reference audio URLs; up to 10 audio files."},"web_search":{"type":"boolean","description":"Whether to enrich the prompt with web search."}},"additionalProperties":false,"required":["prompt","model"],"allOf":[{"if":{"allOf":[{"properties":{"model":{"const":"seedance-2.5"}},"required":["model"]},{"required":["first_frame_image_url"]}]},"then":{"allOf":[{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_urls"]}},{"not":{"required":["reference_audio_urls"]}},{"properties":{"aspect_ratio":{"enum":["auto"]}}}]}},{"if":{"allOf":[{"properties":{"model":{"const":"seedance-2.5"}},"required":["model"]},{"required":["last_frame_image_url"]}]},"then":{"allOf":[{"required":["first_frame_image_url"]},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_urls"]}},{"not":{"required":["reference_audio_urls"]}}]}},{"if":{"properties":{"model":{"const":"seedance-1.5-pro"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["first_frame_image_url"]}},{"not":{"required":["last_frame_image_url"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_urls"]}},{"not":{"required":["reference_audio_urls"]}},{"not":{"required":["web_search"]}},{"not":{"required":["return_last_frame"]}},{"not":{"required":["output_format"]}}]}},{"if":{"properties":{"model":{"const":"seedance-2-mini"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["source_image_urls"]}},{"not":{"required":["lock_camera"]}},{"not":{"required":["seed"]}},{"not":{"required":["enable_safety_checker"]}},{"not":{"required":["return_last_frame"]}},{"not":{"required":["output_format"]}}]}},{"if":{"properties":{"model":{"const":"seedance-2.0"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["source_image_urls"]}},{"not":{"required":["lock_camera"]}},{"not":{"required":["seed"]}},{"not":{"required":["return_last_frame"]}},{"not":{"required":["output_format"]}}]}},{"if":{"properties":{"model":{"const":"seedance-2.0-fast"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["source_image_urls"]}},{"not":{"required":["lock_camera"]}},{"not":{"required":["seed"]}},{"not":{"required":["return_last_frame"]}},{"not":{"required":["output_format"]}}]}},{"if":{"properties":{"model":{"const":"seedance-2.5"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["source_image_urls"]}},{"not":{"required":["lock_camera"]}},{"not":{"required":["seed"]}}]}},{"if":{"properties":{"model":{"const":"seedance-v1-pro"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["source_image_urls"]}},{"not":{"required":["last_frame_image_url"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_urls"]}},{"not":{"required":["reference_audio_urls"]}},{"not":{"required":["web_search"]}},{"not":{"required":["generate_audio"]}},{"not":{"required":["return_last_frame"]}},{"not":{"required":["output_format"]}}]}},{"if":{"properties":{"model":{"const":"seedance-v1-pro-fast"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["aspect_ratio"]}},{"not":{"required":["source_image_urls"]}},{"not":{"required":["lock_camera"]}},{"not":{"required":["last_frame_image_url"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_urls"]}},{"not":{"required":["reference_audio_urls"]}},{"not":{"required":["web_search"]}},{"not":{"required":["generate_audio"]}},{"not":{"required":["return_last_frame"]}},{"not":{"required":["output_format"]}}]}}]},{"type":"object","properties":{"prompt":{"type":"string"},"model":{"type":"string","const":"seedance-v1-pro"},"callback_url":{"type":"string"},"aspect_ratio":{"type":"string","enum":["1:1","4:3","3:4","16:9","9:16","21:9"]},"output_resolution":{"type":"string","enum":["480p","720p","1080p"],"default":"720p"},"duration_seconds":{"type":"integer","enum":[5,10]},"enable_safety_checker":{"type":"boolean"},"lock_camera":{"type":"boolean"},"first_frame_image_url":{"type":"string"},"seed":{"type":"integer"}},"additionalProperties":false,"required":["duration_seconds","model"],"allOf":[{"if":{"allOf":[{"properties":{"model":{"const":"seedance-2.5"}},"required":["model"]},{"required":["first_frame_image_url"]}]},"then":{"allOf":[{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_urls"]}},{"not":{"required":["reference_audio_urls"]}},{"properties":{"aspect_ratio":{"enum":["auto"]}}}]}},{"if":{"allOf":[{"properties":{"model":{"const":"seedance-2.5"}},"required":["model"]},{"required":["last_frame_image_url"]}]},"then":{"allOf":[{"required":["first_frame_image_url"]},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_urls"]}},{"not":{"required":["reference_audio_urls"]}}]}},{"if":{"properties":{"model":{"const":"seedance-1.5-pro"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["first_frame_image_url"]}},{"not":{"required":["last_frame_image_url"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_urls"]}},{"not":{"required":["reference_audio_urls"]}},{"not":{"required":["web_search"]}},{"not":{"required":["return_last_frame"]}},{"not":{"required":["output_format"]}}]}},{"if":{"properties":{"model":{"const":"seedance-2-mini"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["source_image_urls"]}},{"not":{"required":["lock_camera"]}},{"not":{"required":["seed"]}},{"not":{"required":["enable_safety_checker"]}},{"not":{"required":["return_last_frame"]}},{"not":{"required":["output_format"]}}]}},{"if":{"properties":{"model":{"const":"seedance-2.0"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["source_image_urls"]}},{"not":{"required":["lock_camera"]}},{"not":{"required":["seed"]}},{"not":{"required":["return_last_frame"]}},{"not":{"required":["output_format"]}}]}},{"if":{"properties":{"model":{"const":"seedance-2.0-fast"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["source_image_urls"]}},{"not":{"required":["lock_camera"]}},{"not":{"required":["seed"]}},{"not":{"required":["return_last_frame"]}},{"not":{"required":["output_format"]}}]}},{"if":{"properties":{"model":{"const":"seedance-2.5"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["source_image_urls"]}},{"not":{"required":["lock_camera"]}},{"not":{"required":["seed"]}}]}},{"if":{"properties":{"model":{"const":"seedance-v1-pro"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["source_image_urls"]}},{"not":{"required":["last_frame_image_url"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_urls"]}},{"not":{"required":["reference_audio_urls"]}},{"not":{"required":["web_search"]}},{"not":{"required":["generate_audio"]}},{"not":{"required":["return_last_frame"]}},{"not":{"required":["output_format"]}}]}},{"if":{"properties":{"model":{"const":"seedance-v1-pro-fast"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["aspect_ratio"]}},{"not":{"required":["source_image_urls"]}},{"not":{"required":["lock_camera"]}},{"not":{"required":["last_frame_image_url"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_urls"]}},{"not":{"required":["reference_audio_urls"]}},{"not":{"required":["web_search"]}},{"not":{"required":["generate_audio"]}},{"not":{"required":["return_last_frame"]}},{"not":{"required":["output_format"]}}]}}]},{"type":"object","properties":{"prompt":{"type":"string"},"model":{"type":"string","const":"seedance-v1-pro-fast"},"callback_url":{"type":"string"},"output_resolution":{"type":"string","enum":["720p","1080p"],"default":"720p"},"duration_seconds":{"type":"integer","enum":[5,10]},"enable_safety_checker":{"type":"boolean"},"first_frame_image_url":{"type":"string"},"seed":{"type":"integer","maximum":2147483647,"minimum":-1}},"additionalProperties":false,"required":["duration_seconds","first_frame_image_url","model"],"allOf":[{"if":{"allOf":[{"properties":{"model":{"const":"seedance-2.5"}},"required":["model"]},{"required":["first_frame_image_url"]}]},"then":{"allOf":[{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_urls"]}},{"not":{"required":["reference_audio_urls"]}},{"properties":{"aspect_ratio":{"enum":["auto"]}}}]}},{"if":{"allOf":[{"properties":{"model":{"const":"seedance-2.5"}},"required":["model"]},{"required":["last_frame_image_url"]}]},"then":{"allOf":[{"required":["first_frame_image_url"]},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_urls"]}},{"not":{"required":["reference_audio_urls"]}}]}},{"if":{"properties":{"model":{"const":"seedance-1.5-pro"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["first_frame_image_url"]}},{"not":{"required":["last_frame_image_url"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_urls"]}},{"not":{"required":["reference_audio_urls"]}},{"not":{"required":["web_search"]}},{"not":{"required":["return_last_frame"]}},{"not":{"required":["output_format"]}}]}},{"if":{"properties":{"model":{"const":"seedance-2-mini"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["source_image_urls"]}},{"not":{"required":["lock_camera"]}},{"not":{"required":["seed"]}},{"not":{"required":["enable_safety_checker"]}},{"not":{"required":["return_last_frame"]}},{"not":{"required":["output_format"]}}]}},{"if":{"properties":{"model":{"const":"seedance-2.0"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["source_image_urls"]}},{"not":{"required":["lock_camera"]}},{"not":{"required":["seed"]}},{"not":{"required":["return_last_frame"]}},{"not":{"required":["output_format"]}}]}},{"if":{"properties":{"model":{"const":"seedance-2.0-fast"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["source_image_urls"]}},{"not":{"required":["lock_camera"]}},{"not":{"required":["seed"]}},{"not":{"required":["return_last_frame"]}},{"not":{"required":["output_format"]}}]}},{"if":{"properties":{"model":{"const":"seedance-2.5"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["source_image_urls"]}},{"not":{"required":["lock_camera"]}},{"not":{"required":["seed"]}}]}},{"if":{"properties":{"model":{"const":"seedance-v1-pro"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["source_image_urls"]}},{"not":{"required":["last_frame_image_url"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_urls"]}},{"not":{"required":["reference_audio_urls"]}},{"not":{"required":["web_search"]}},{"not":{"required":["generate_audio"]}},{"not":{"required":["return_last_frame"]}},{"not":{"required":["output_format"]}}]}},{"if":{"properties":{"model":{"const":"seedance-v1-pro-fast"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["aspect_ratio"]}},{"not":{"required":["source_image_urls"]}},{"not":{"required":["lock_camera"]}},{"not":{"required":["last_frame_image_url"]}},{"not":{"required":["reference_image_urls"]}},{"not":{"required":["reference_video_urls"]}},{"not":{"required":["reference_audio_urls"]}},{"not":{"required":["web_search"]}},{"not":{"required":["generate_audio"]}},{"not":{"required":["return_last_frame"]}},{"not":{"required":["output_format"]}}]}}]}]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/seedance/text_to_video/{id}":{"get":{"tags":["Seedance"],"summary":"Retrieve Seedance Text-to-Video task","description":"Create an asynchronous task through the Seedance text to video endpoint.","operationId":"task_endpoint_seedance_text_to_video_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","videos","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"videos":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"last_frame_image_url":{"type":"string","x-runapi-generated-media":true},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/seedream/decompose_layers":{"post":{"tags":["Seedream"],"summary":"Seedream Decompose-Layers","description":"Create an asynchronous task through the Seedream decompose layers endpoint.","operationId":"task_endpoint_seedream_decompose_layers","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"model":{"type":"string","const":"seedream-5-pro-layer-decomposition"},"image_url":{"type":"string","pattern":"^https?://","description":"Exactly one public PNG, JPEG, WebP, BMP, TIFF, or GIF image URL; HEIC and HEIF are unsupported. Maximum 30 MB, 262,144-36,000,000 total pixels, and aspect ratio 1:16-16:1."},"prompt":{"type":"string","maxLength":5000,"description":"Optional instructions describing which elements to separate."},"size":{"type":"string","enum":["auto","1K","1.5K","2K"],"default":"auto"},"output_format":{"type":"string","enum":["png","jpeg"],"default":"jpeg","description":"Base image format. Separated layers are PNG."},"callback_url":{"type":"string"}},"additionalProperties":false,"required":["image_url","model"]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/seedream/decompose_layers/{id}":{"get":{"tags":["Seedream"],"summary":"Retrieve Seedream Decompose-Layers task","description":"Create an asynchronous task through the Seedream decompose layers endpoint.","operationId":"task_endpoint_seedream_decompose_layers_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","base_image","layers","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"base_image":{"type":"object","properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false},"layers":{"type":"array","items":{"type":"object","required":["url","z_index"],"properties":{"url":{"type":"string","x-runapi-generated-media":true},"z_index":{"type":"integer"},"bounding_box":{"type":"object","properties":{"absolute":{"type":"array","items":{"type":"integer"}},"normalized":{"type":"array","items":{"type":"integer"}}}},"name":{"type":"string"},"description":{"type":"string"}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"},"generated_images":{"type":"integer","minimum":2,"maximum":17,"description":"Number of delivered images, including the base image."}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/seedream/edit_image":{"post":{"tags":["Seedream"],"summary":"Seedream Edit-Image","description":"Create an asynchronous task through the Seedream edit image endpoint.","operationId":"task_endpoint_seedream_edit_image","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"model":{"type":"string","const":"seedream-4.5-edit"},"prompt":{"type":"string"},"aspect_ratio":{"type":"string","enum":["1:1","4:3","3:4","16:9","9:16","2:3","3:2","21:9"]},"output_quality":{"type":"string","enum":["basic","high"]},"source_image_urls":{"type":"array","maxItems":14,"minItems":1},"output_resolution":{"type":"string"},"output_count":{"type":"integer"},"seed":{"type":"integer"},"enable_safety_checker":{"type":"boolean"},"callback_url":{"type":"string"}},"additionalProperties":false,"required":["aspect_ratio","output_quality","source_image_urls","model"],"allOf":[{"if":{"properties":{"model":{"const":"seedream-4.5-edit"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_format"]}},{"not":{"required":["background"]}}]}},{"if":{"properties":{"model":{"const":"seedream-5-lite-edit"}},"required":["model"]},"then":{"not":{"required":["background"]}}},{"if":{"properties":{"model":{"const":"seedream-5-pro-edit"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["output_count"]}},{"not":{"required":["seed"]}}]}},{"if":{"allOf":[{"properties":{"model":{"const":"seedream-5-pro-edit"}},"required":["model"]},{"required":["background"]}]},"then":{"properties":{"output_format":{"enum":["png"]}}}},{"if":{"properties":{"model":{"const":"seedream-v4-edit"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_format"]}},{"not":{"required":["background"]}}]}}]},{"type":"object","properties":{"model":{"type":"string","const":"seedream-5-lite-edit"},"prompt":{"type":"string","maxLength":2995,"minLength":4},"aspect_ratio":{"type":"string","enum":["1:1","4:3","3:4","16:9","9:16","2:3","3:2","21:9"]},"output_quality":{"type":"string","enum":["basic","high","ultra"]},"output_format":{"type":"string","enum":["png","jpeg"],"default":"png"},"source_image_urls":{"type":"array","maxItems":14,"minItems":1},"output_resolution":{"type":"string"},"output_count":{"type":"integer"},"seed":{"type":"integer"},"enable_safety_checker":{"type":"boolean"},"callback_url":{"type":"string"}},"additionalProperties":false,"required":["prompt","aspect_ratio","output_quality","source_image_urls","model"],"allOf":[{"if":{"properties":{"model":{"const":"seedream-4.5-edit"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_format"]}},{"not":{"required":["background"]}}]}},{"if":{"properties":{"model":{"const":"seedream-5-lite-edit"}},"required":["model"]},"then":{"not":{"required":["background"]}}},{"if":{"properties":{"model":{"const":"seedream-5-pro-edit"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["output_count"]}},{"not":{"required":["seed"]}}]}},{"if":{"allOf":[{"properties":{"model":{"const":"seedream-5-pro-edit"}},"required":["model"]},{"required":["background"]}]},"then":{"properties":{"output_format":{"enum":["png"]}}}},{"if":{"properties":{"model":{"const":"seedream-v4-edit"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_format"]}},{"not":{"required":["background"]}}]}}]},{"type":"object","properties":{"model":{"type":"string","const":"seedream-5-pro-edit"},"prompt":{"type":"string","maxLength":5000,"minLength":4},"aspect_ratio":{"type":"string","enum":["1:1","4:3","3:4","16:9","9:16","2:3","3:2","21:9"]},"output_quality":{"type":"string","enum":["basic","high"]},"output_format":{"type":"string","enum":["png","jpeg"],"default":"png"},"source_image_urls":{"type":"array","maxItems":10,"minItems":1},"background":{"type":"string","enum":["transparent"],"description":"Keep the transparent background of the source image. Requires exactly one PNG source image with an alpha channel and output_format png."},"enable_safety_checker":{"type":"boolean"},"callback_url":{"type":"string"}},"additionalProperties":false,"required":["prompt","aspect_ratio","output_quality","source_image_urls","model"],"allOf":[{"if":{"properties":{"model":{"const":"seedream-4.5-edit"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_format"]}},{"not":{"required":["background"]}}]}},{"if":{"properties":{"model":{"const":"seedream-5-lite-edit"}},"required":["model"]},"then":{"not":{"required":["background"]}}},{"if":{"properties":{"model":{"const":"seedream-5-pro-edit"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["output_count"]}},{"not":{"required":["seed"]}}]}},{"if":{"allOf":[{"properties":{"model":{"const":"seedream-5-pro-edit"}},"required":["model"]},{"required":["background"]}]},"then":{"properties":{"output_format":{"enum":["png"]}}}},{"if":{"properties":{"model":{"const":"seedream-v4-edit"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_format"]}},{"not":{"required":["background"]}}]}}]},{"type":"object","properties":{"model":{"type":"string","const":"seedream-v4-edit"},"prompt":{"type":"string"},"aspect_ratio":{"type":"string","enum":["1:1","4:3","3:4","3:2","2:3","16:9","9:16","21:9"],"default":"1:1"},"output_quality":{"type":"string"},"source_image_urls":{"type":"array","maxItems":10,"minItems":1},"output_resolution":{"type":"string","enum":["1k","2k","4k"],"default":"2k"},"output_count":{"type":"integer","enum":[1,2,3,4,5,6],"default":1},"seed":{"type":"integer","maximum":1000000},"enable_safety_checker":{"type":"boolean"},"callback_url":{"type":"string"}},"additionalProperties":false,"required":["source_image_urls","model"],"allOf":[{"if":{"properties":{"model":{"const":"seedream-4.5-edit"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_format"]}},{"not":{"required":["background"]}}]}},{"if":{"properties":{"model":{"const":"seedream-5-lite-edit"}},"required":["model"]},"then":{"not":{"required":["background"]}}},{"if":{"properties":{"model":{"const":"seedream-5-pro-edit"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["output_count"]}},{"not":{"required":["seed"]}}]}},{"if":{"allOf":[{"properties":{"model":{"const":"seedream-5-pro-edit"}},"required":["model"]},{"required":["background"]}]},"then":{"properties":{"output_format":{"enum":["png"]}}}},{"if":{"properties":{"model":{"const":"seedream-v4-edit"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_format"]}},{"not":{"required":["background"]}}]}}]}]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/seedream/edit_image/{id}":{"get":{"tags":["Seedream"],"summary":"Retrieve Seedream Edit-Image task","description":"Create an asynchronous task through the Seedream edit image endpoint.","operationId":"task_endpoint_seedream_edit_image_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","images","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"images":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/seedream/text_to_image":{"post":{"tags":["Seedream"],"summary":"Seedream Text-to-Image","description":"Create an asynchronous task through the Seedream text to image endpoint.","operationId":"task_endpoint_seedream_text_to_image","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"model":{"type":"string","const":"seedream-4.5-text-to-image"},"prompt":{"type":"string"},"aspect_ratio":{"type":"string","enum":["1:1","4:3","3:4","16:9","9:16","2:3","3:2","21:9"]},"output_quality":{"type":"string","enum":["basic","high"]},"output_resolution":{"type":"string"},"output_count":{"type":"integer"},"seed":{"type":"integer"},"enable_safety_checker":{"type":"boolean"},"callback_url":{"type":"string"}},"additionalProperties":false,"required":["aspect_ratio","output_quality","model"],"allOf":[{"if":{"properties":{"model":{"const":"seedream-4.5-text-to-image"}},"required":["model"]},"then":{"not":{"required":["output_format"]}}},{"if":{"properties":{"model":{"const":"seedream-5-pro-text-to-image"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["output_count"]}},{"not":{"required":["seed"]}}]}},{"if":{"properties":{"model":{"const":"seedream-v4-text-to-image"}},"required":["model"]},"then":{"not":{"required":["output_format"]}}}]},{"type":"object","properties":{"model":{"type":"string","const":"seedream-5-lite-text-to-image"},"prompt":{"type":"string","maxLength":2995,"minLength":4},"aspect_ratio":{"type":"string","enum":["1:1","4:3","3:4","16:9","9:16","2:3","3:2","21:9"]},"output_quality":{"type":"string","enum":["basic","high","ultra"]},"output_format":{"type":"string","enum":["png","jpeg"],"default":"png"},"output_resolution":{"type":"string"},"output_count":{"type":"integer"},"seed":{"type":"integer"},"enable_safety_checker":{"type":"boolean"},"callback_url":{"type":"string"}},"additionalProperties":false,"required":["prompt","aspect_ratio","output_quality","model"],"allOf":[{"if":{"properties":{"model":{"const":"seedream-4.5-text-to-image"}},"required":["model"]},"then":{"not":{"required":["output_format"]}}},{"if":{"properties":{"model":{"const":"seedream-5-pro-text-to-image"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["output_count"]}},{"not":{"required":["seed"]}}]}},{"if":{"properties":{"model":{"const":"seedream-v4-text-to-image"}},"required":["model"]},"then":{"not":{"required":["output_format"]}}}]},{"type":"object","properties":{"model":{"type":"string","const":"seedream-5-pro-text-to-image"},"prompt":{"type":"string","maxLength":5000,"minLength":4},"aspect_ratio":{"type":"string","enum":["1:1","4:3","3:4","16:9","9:16","2:3","3:2","21:9"]},"output_quality":{"type":"string","enum":["basic","high"]},"output_format":{"type":"string","enum":["png","jpeg"],"default":"png"},"enable_safety_checker":{"type":"boolean"},"callback_url":{"type":"string"}},"additionalProperties":false,"required":["prompt","aspect_ratio","output_quality","model"],"allOf":[{"if":{"properties":{"model":{"const":"seedream-4.5-text-to-image"}},"required":["model"]},"then":{"not":{"required":["output_format"]}}},{"if":{"properties":{"model":{"const":"seedream-5-pro-text-to-image"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["output_count"]}},{"not":{"required":["seed"]}}]}},{"if":{"properties":{"model":{"const":"seedream-v4-text-to-image"}},"required":["model"]},"then":{"not":{"required":["output_format"]}}}]},{"type":"object","properties":{"model":{"type":"string","const":"seedream-v4-text-to-image"},"prompt":{"type":"string"},"aspect_ratio":{"type":"string","enum":["1:1","4:3","3:4","3:2","2:3","16:9","9:16","21:9"],"default":"1:1"},"output_quality":{"type":"string"},"output_resolution":{"type":"string","enum":["1k","2k","4k"],"default":"2k"},"output_count":{"type":"integer","enum":[1,2,3,4,5,6],"default":1},"seed":{"type":"integer","maximum":1000000},"enable_safety_checker":{"type":"boolean"},"callback_url":{"type":"string"}},"additionalProperties":false,"required":["model"],"allOf":[{"if":{"properties":{"model":{"const":"seedream-4.5-text-to-image"}},"required":["model"]},"then":{"not":{"required":["output_format"]}}},{"if":{"properties":{"model":{"const":"seedream-5-pro-text-to-image"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["output_resolution"]}},{"not":{"required":["output_count"]}},{"not":{"required":["seed"]}}]}},{"if":{"properties":{"model":{"const":"seedream-v4-text-to-image"}},"required":["model"]},"then":{"not":{"required":["output_format"]}}}]}]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/seedream/text_to_image/{id}":{"get":{"tags":["Seedream"],"summary":"Retrieve Seedream Text-to-Image task","description":"Create an asynchronous task through the Seedream text to image endpoint.","operationId":"task_endpoint_seedream_text_to_image_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","images","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"images":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/style_expansions":{"post":{"tags":["Suno"],"summary":"Suno Style-Expansions","description":"Send a synchronous request through the Suno style expansions endpoint.","operationId":"task_endpoint_suno_style_expansions","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"description":{"type":"string","description":"Style description to expand into genre tags."}},"additionalProperties":false,"required":["description"]}}}},"responses":{"200":{"description":"Sync success","content":{"application/json":{"schema":{"type":"object","required":["style"],"properties":{"style":{"type":"string"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/suno/add_instrumental":{"post":{"tags":["Suno"],"summary":"Suno Add-Instrumental","description":"Create an asynchronous task through the Suno add instrumental endpoint.","operationId":"task_endpoint_suno_add_instrumental","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"callback_url":{"type":"string","description":"Webhook URL for async notifications."},"model":{"type":"string","description":"Model slug.","const":"suno-v4.5-plus"},"vocal_gender":{"type":"string","enum":["male","female"],"description":"Vocal gender."},"style_weight":{"type":"number","maximum":1,"minimum":0,"description":"Style adherence weight (0-1)."},"weirdness_constraint":{"type":"number","maximum":1,"minimum":0,"description":"Weirdness constraint (0-1)."},"audio_weight":{"type":"number","maximum":1,"minimum":0,"description":"Audio weight (0-1)."},"upload_url":{"type":"string","description":"URL of the audio file to add instrumentation to."},"title":{"type":"string","maxLength":80,"description":"Song title."},"negative_tags":{"type":"string","maxLength":200,"description":"Styles to avoid."},"tags":{"type":"string","maxLength":1000,"description":"Style or genre tags."}},"additionalProperties":false,"required":["model","upload_url","title","negative_tags","tags"]},{"type":"object","properties":{"callback_url":{"type":"string","description":"Webhook URL for async notifications."},"model":{"type":"string","description":"Model slug.","const":"suno-v5"},"vocal_gender":{"type":"string","enum":["male","female"],"description":"Vocal gender."},"style_weight":{"type":"number","maximum":1,"minimum":0,"description":"Style adherence weight (0-1)."},"weirdness_constraint":{"type":"number","maximum":1,"minimum":0,"description":"Weirdness constraint (0-1)."},"audio_weight":{"type":"number","maximum":1,"minimum":0,"description":"Audio weight (0-1)."},"upload_url":{"type":"string","description":"URL of the audio file to add instrumentation to."},"title":{"type":"string","maxLength":80,"description":"Song title."},"negative_tags":{"type":"string","maxLength":200,"description":"Styles to avoid."},"tags":{"type":"string","maxLength":1000,"description":"Style or genre tags."}},"additionalProperties":false,"required":["model","upload_url","title","negative_tags","tags"]},{"type":"object","properties":{"callback_url":{"type":"string","description":"Webhook URL for async notifications."},"model":{"type":"string","description":"Model slug.","const":"suno-v5.5"},"vocal_gender":{"type":"string","enum":["male","female"],"description":"Vocal gender."},"style_weight":{"type":"number","maximum":1,"minimum":0,"description":"Style adherence weight (0-1)."},"weirdness_constraint":{"type":"number","maximum":1,"minimum":0,"description":"Weirdness constraint (0-1)."},"audio_weight":{"type":"number","maximum":1,"minimum":0,"description":"Audio weight (0-1)."},"upload_url":{"type":"string","description":"URL of the audio file to add instrumentation to."},"title":{"type":"string","maxLength":80,"description":"Song title."},"negative_tags":{"type":"string","maxLength":200,"description":"Styles to avoid."},"tags":{"type":"string","maxLength":1000,"description":"Style or genre tags."}},"additionalProperties":false,"required":["model","upload_url","title","negative_tags","tags"]}]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/suno/add_instrumental/{id}":{"get":{"tags":["Suno"],"summary":"Retrieve Suno Add-Instrumental task","description":"Create an asynchronous task through the Suno add instrumental endpoint.","operationId":"task_endpoint_suno_add_instrumental_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"generation_stage":{"type":"string","enum":["text_generated","first_audio_ready"]},"audios":{"type":"array","items":{"type":"object","required":["id"],"properties":{"id":{"type":"string"},"audio_url":{"type":"string","x-runapi-generated-media":true},"stream_audio_url":{"type":"string","x-runapi-generated-media":true},"image_url":{"type":"string","x-runapi-generated-media":true},"lyrics":{"type":"string"},"model_name":{"type":"string"},"title":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"duration":{"type":"number"}},"unevaluatedProperties":false}}},"unevaluatedProperties":false},{"type":"object","required":["id","status","audios","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"generation_stage":{"type":"string","enum":["text_generated","first_audio_ready","all_audios_ready","failed"]},"audios":{"type":"array","items":{"type":"object","required":["id"],"properties":{"id":{"type":"string"},"audio_url":{"type":"string","x-runapi-generated-media":true},"stream_audio_url":{"type":"string","x-runapi-generated-media":true},"image_url":{"type":"string","x-runapi-generated-media":true},"lyrics":{"type":"string"},"model_name":{"type":"string"},"title":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"duration":{"type":"number"}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/suno/add_vocals":{"post":{"tags":["Suno"],"summary":"Suno Add-Vocals","description":"Create an asynchronous task through the Suno add vocals endpoint.","operationId":"task_endpoint_suno_add_vocals","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"callback_url":{"type":"string","description":"Webhook URL for async notifications."},"model":{"type":"string","description":"Model slug.","const":"suno-v4.5-plus"},"vocal_gender":{"type":"string","enum":["male","female"],"description":"Vocal gender."},"style_weight":{"type":"number","maximum":1,"minimum":0,"description":"Style adherence weight (0-1)."},"weirdness_constraint":{"type":"number","maximum":1,"minimum":0,"description":"Weirdness constraint (0-1)."},"audio_weight":{"type":"number","maximum":1,"minimum":0,"description":"Audio weight (0-1)."},"upload_url":{"type":"string","description":"URL of the audio file to add vocals to."},"lyrics":{"type":"string","maxLength":5000,"description":"Vocal lyrics to sing."},"title":{"type":"string","maxLength":80,"description":"Song title."},"negative_tags":{"type":"string","maxLength":200,"description":"Styles to avoid."},"style":{"type":"string","maxLength":1000,"description":"Style preset."}},"additionalProperties":false,"required":["model","upload_url","lyrics","title","negative_tags","style"]},{"type":"object","properties":{"callback_url":{"type":"string","description":"Webhook URL for async notifications."},"model":{"type":"string","description":"Model slug.","const":"suno-v5"},"vocal_gender":{"type":"string","enum":["male","female"],"description":"Vocal gender."},"style_weight":{"type":"number","maximum":1,"minimum":0,"description":"Style adherence weight (0-1)."},"weirdness_constraint":{"type":"number","maximum":1,"minimum":0,"description":"Weirdness constraint (0-1)."},"audio_weight":{"type":"number","maximum":1,"minimum":0,"description":"Audio weight (0-1)."},"upload_url":{"type":"string","description":"URL of the audio file to add vocals to."},"lyrics":{"type":"string","maxLength":5000,"description":"Vocal lyrics to sing."},"title":{"type":"string","maxLength":80,"description":"Song title."},"negative_tags":{"type":"string","maxLength":200,"description":"Styles to avoid."},"style":{"type":"string","maxLength":1000,"description":"Style preset."}},"additionalProperties":false,"required":["model","upload_url","lyrics","title","negative_tags","style"]}]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/suno/add_vocals/{id}":{"get":{"tags":["Suno"],"summary":"Retrieve Suno Add-Vocals task","description":"Create an asynchronous task through the Suno add vocals endpoint.","operationId":"task_endpoint_suno_add_vocals_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"generation_stage":{"type":"string","enum":["text_generated","first_audio_ready"]},"audios":{"type":"array","items":{"type":"object","required":["id"],"properties":{"id":{"type":"string"},"audio_url":{"type":"string","x-runapi-generated-media":true},"stream_audio_url":{"type":"string","x-runapi-generated-media":true},"image_url":{"type":"string","x-runapi-generated-media":true},"lyrics":{"type":"string"},"model_name":{"type":"string"},"title":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"duration":{"type":"number"}},"unevaluatedProperties":false}}},"unevaluatedProperties":false},{"type":"object","required":["id","status","audios","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"generation_stage":{"type":"string","enum":["text_generated","first_audio_ready","all_audios_ready","failed"]},"audios":{"type":"array","items":{"type":"object","required":["id"],"properties":{"id":{"type":"string"},"audio_url":{"type":"string","x-runapi-generated-media":true},"stream_audio_url":{"type":"string","x-runapi-generated-media":true},"image_url":{"type":"string","x-runapi-generated-media":true},"lyrics":{"type":"string"},"model_name":{"type":"string"},"title":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"duration":{"type":"number"}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/suno/blend_lyrics":{"post":{"tags":["Suno"],"summary":"Suno Blend-Lyrics","description":"Create an asynchronous task through the Suno blend lyrics endpoint.","operationId":"task_endpoint_suno_blend_lyrics","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"lyrics_a":{"type":"string","description":"First lyrics text to blend."},"lyrics_b":{"type":"string","description":"Second lyrics text to blend."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."}},"additionalProperties":false,"required":["lyrics_a","lyrics_b"]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/suno/blend_lyrics/{id}":{"get":{"tags":["Suno"],"summary":"Retrieve Suno Blend-Lyrics task","description":"Create an asynchronous task through the Suno blend lyrics endpoint.","operationId":"task_endpoint_suno_blend_lyrics_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"lyrics":{"type":"array","items":{"type":"object","required":["text"],"properties":{"title":{"type":"string"},"text":{"type":"string"}},"unevaluatedProperties":false}}},"unevaluatedProperties":false},{"type":"object","required":["id","status","lyrics","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"lyrics":{"type":"array","items":{"type":"object","required":["text"],"properties":{"title":{"type":"string"},"text":{"type":"string"}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/suno/cover_audio":{"post":{"tags":["Suno"],"summary":"Suno Cover-Audio","description":"Create an asynchronous task through the Suno cover audio endpoint.","operationId":"task_endpoint_suno_cover_audio","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"callback_url":{"type":"string","description":"Webhook URL for async notifications."},"model":{"type":"string","description":"Model slug.","const":"suno-v4"},"vocal_gender":{"type":"string","enum":["male","female"],"description":"Vocal gender."},"style_weight":{"type":"number","maximum":1,"minimum":0,"description":"Style adherence weight (0-1)."},"weirdness_constraint":{"type":"number","maximum":1,"minimum":0,"description":"Weirdness constraint (0-1)."},"audio_weight":{"type":"number","maximum":1,"minimum":0,"description":"Audio weight (0-1)."},"upload_url":{"type":"string","description":"URL of the audio file to cover."},"vocal_mode":{"type":"string","enum":["auto_lyrics","exact_lyrics","instrumental"],"description":"Vocal generation mode."},"prompt":{"type":"string","maxLength":5000,"description":"Cover brief for automatic lyrics."},"lyrics":{"type":"string","maxLength":5000,"description":"Exact cover lyrics to sing."},"style":{"type":"string","maxLength":1000,"description":"Music style."},"title":{"type":"string","maxLength":80,"description":"Music title."},"persona_id":{"type":"string","description":"Persona ID."},"persona_type":{"type":"string","enum":["style","voice"],"description":"Persona type."},"negative_tags":{"type":"string","maxLength":200,"description":"Styles to avoid."}},"additionalProperties":false,"required":["model","upload_url","vocal_mode"],"allOf":[{"if":{"properties":{"vocal_mode":{"const":"auto_lyrics"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["prompt"]},{"not":{"required":["lyrics"]}},{"not":{"required":["style"]}},{"not":{"required":["title"]}}]}},{"if":{"properties":{"vocal_mode":{"const":"exact_lyrics"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["lyrics","style","title"]},{"not":{"required":["prompt"]}}]}},{"if":{"properties":{"vocal_mode":{"const":"instrumental"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["style","title"]},{"not":{"required":["prompt"]}},{"not":{"required":["lyrics"]}}]}}]},{"type":"object","properties":{"callback_url":{"type":"string","description":"Webhook URL for async notifications."},"model":{"type":"string","description":"Model slug.","const":"suno-v4.5"},"vocal_gender":{"type":"string","enum":["male","female"],"description":"Vocal gender."},"style_weight":{"type":"number","maximum":1,"minimum":0,"description":"Style adherence weight (0-1)."},"weirdness_constraint":{"type":"number","maximum":1,"minimum":0,"description":"Weirdness constraint (0-1)."},"audio_weight":{"type":"number","maximum":1,"minimum":0,"description":"Audio weight (0-1)."},"upload_url":{"type":"string","description":"URL of the audio file to cover."},"vocal_mode":{"type":"string","enum":["auto_lyrics","exact_lyrics","instrumental"],"description":"Vocal generation mode."},"prompt":{"type":"string","maxLength":5000,"description":"Cover brief for automatic lyrics."},"lyrics":{"type":"string","maxLength":5000,"description":"Exact cover lyrics to sing."},"style":{"type":"string","maxLength":1000,"description":"Music style."},"title":{"type":"string","maxLength":80,"description":"Music title."},"persona_id":{"type":"string","description":"Persona ID."},"persona_type":{"type":"string","enum":["style","voice"],"description":"Persona type."},"negative_tags":{"type":"string","maxLength":200,"description":"Styles to avoid."}},"additionalProperties":false,"required":["model","upload_url","vocal_mode"],"allOf":[{"if":{"properties":{"vocal_mode":{"const":"auto_lyrics"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["prompt"]},{"not":{"required":["lyrics"]}},{"not":{"required":["style"]}},{"not":{"required":["title"]}}]}},{"if":{"properties":{"vocal_mode":{"const":"exact_lyrics"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["lyrics","style","title"]},{"not":{"required":["prompt"]}}]}},{"if":{"properties":{"vocal_mode":{"const":"instrumental"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["style","title"]},{"not":{"required":["prompt"]}},{"not":{"required":["lyrics"]}}]}}]},{"type":"object","properties":{"callback_url":{"type":"string","description":"Webhook URL for async notifications."},"model":{"type":"string","description":"Model slug.","const":"suno-v4.5-all"},"vocal_gender":{"type":"string","enum":["male","female"],"description":"Vocal gender."},"style_weight":{"type":"number","maximum":1,"minimum":0,"description":"Style adherence weight (0-1)."},"weirdness_constraint":{"type":"number","maximum":1,"minimum":0,"description":"Weirdness constraint (0-1)."},"audio_weight":{"type":"number","maximum":1,"minimum":0,"description":"Audio weight (0-1)."},"upload_url":{"type":"string","description":"URL of the audio file to cover."},"vocal_mode":{"type":"string","enum":["auto_lyrics","exact_lyrics","instrumental"],"description":"Vocal generation mode."},"prompt":{"type":"string","maxLength":5000,"description":"Cover brief for automatic lyrics."},"lyrics":{"type":"string","maxLength":5000,"description":"Exact cover lyrics to sing."},"style":{"type":"string","maxLength":1000,"description":"Music style."},"title":{"type":"string","maxLength":80,"description":"Music title."},"persona_id":{"type":"string","description":"Persona ID."},"persona_type":{"type":"string","enum":["style","voice"],"description":"Persona type."},"negative_tags":{"type":"string","maxLength":200,"description":"Styles to avoid."}},"additionalProperties":false,"required":["model","upload_url","vocal_mode"],"allOf":[{"if":{"properties":{"vocal_mode":{"const":"auto_lyrics"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["prompt"]},{"not":{"required":["lyrics"]}},{"not":{"required":["style"]}},{"not":{"required":["title"]}}]}},{"if":{"properties":{"vocal_mode":{"const":"exact_lyrics"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["lyrics","style","title"]},{"not":{"required":["prompt"]}}]}},{"if":{"properties":{"vocal_mode":{"const":"instrumental"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["style","title"]},{"not":{"required":["prompt"]}},{"not":{"required":["lyrics"]}}]}}]},{"type":"object","properties":{"callback_url":{"type":"string","description":"Webhook URL for async notifications."},"model":{"type":"string","description":"Model slug.","const":"suno-v4.5-plus"},"vocal_gender":{"type":"string","enum":["male","female"],"description":"Vocal gender."},"style_weight":{"type":"number","maximum":1,"minimum":0,"description":"Style adherence weight (0-1)."},"weirdness_constraint":{"type":"number","maximum":1,"minimum":0,"description":"Weirdness constraint (0-1)."},"audio_weight":{"type":"number","maximum":1,"minimum":0,"description":"Audio weight (0-1)."},"upload_url":{"type":"string","description":"URL of the audio file to cover."},"vocal_mode":{"type":"string","enum":["auto_lyrics","exact_lyrics","instrumental"],"description":"Vocal generation mode."},"prompt":{"type":"string","maxLength":5000,"description":"Cover brief for automatic lyrics."},"lyrics":{"type":"string","maxLength":5000,"description":"Exact cover lyrics to sing."},"style":{"type":"string","maxLength":1000,"description":"Music style."},"title":{"type":"string","maxLength":80,"description":"Music title."},"persona_id":{"type":"string","description":"Persona ID."},"persona_type":{"type":"string","enum":["style","voice"],"description":"Persona type."},"negative_tags":{"type":"string","maxLength":200,"description":"Styles to avoid."}},"additionalProperties":false,"required":["model","upload_url","vocal_mode"],"allOf":[{"if":{"properties":{"vocal_mode":{"const":"auto_lyrics"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["prompt"]},{"not":{"required":["lyrics"]}},{"not":{"required":["style"]}},{"not":{"required":["title"]}}]}},{"if":{"properties":{"vocal_mode":{"const":"exact_lyrics"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["lyrics","style","title"]},{"not":{"required":["prompt"]}}]}},{"if":{"properties":{"vocal_mode":{"const":"instrumental"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["style","title"]},{"not":{"required":["prompt"]}},{"not":{"required":["lyrics"]}}]}}]},{"type":"object","properties":{"callback_url":{"type":"string","description":"Webhook URL for async notifications."},"model":{"type":"string","description":"Model slug.","const":"suno-v5"},"vocal_gender":{"type":"string","enum":["male","female"],"description":"Vocal gender."},"style_weight":{"type":"number","maximum":1,"minimum":0,"description":"Style adherence weight (0-1)."},"weirdness_constraint":{"type":"number","maximum":1,"minimum":0,"description":"Weirdness constraint (0-1)."},"audio_weight":{"type":"number","maximum":1,"minimum":0,"description":"Audio weight (0-1)."},"upload_url":{"type":"string","description":"URL of the audio file to cover."},"vocal_mode":{"type":"string","enum":["auto_lyrics","exact_lyrics","instrumental"],"description":"Vocal generation mode."},"prompt":{"type":"string","maxLength":5000,"description":"Cover brief for automatic lyrics."},"lyrics":{"type":"string","maxLength":5000,"description":"Exact cover lyrics to sing."},"style":{"type":"string","maxLength":1000,"description":"Music style."},"title":{"type":"string","maxLength":80,"description":"Music title."},"persona_id":{"type":"string","description":"Persona ID."},"persona_type":{"type":"string","enum":["style","voice"],"description":"Persona type."},"negative_tags":{"type":"string","maxLength":200,"description":"Styles to avoid."}},"additionalProperties":false,"required":["model","upload_url","vocal_mode"],"allOf":[{"if":{"properties":{"vocal_mode":{"const":"auto_lyrics"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["prompt"]},{"not":{"required":["lyrics"]}},{"not":{"required":["style"]}},{"not":{"required":["title"]}}]}},{"if":{"properties":{"vocal_mode":{"const":"exact_lyrics"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["lyrics","style","title"]},{"not":{"required":["prompt"]}}]}},{"if":{"properties":{"vocal_mode":{"const":"instrumental"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["style","title"]},{"not":{"required":["prompt"]}},{"not":{"required":["lyrics"]}}]}}]},{"type":"object","properties":{"callback_url":{"type":"string","description":"Webhook URL for async notifications."},"model":{"type":"string","description":"Model slug.","const":"suno-v5.5"},"vocal_gender":{"type":"string","enum":["male","female"],"description":"Vocal gender."},"style_weight":{"type":"number","maximum":1,"minimum":0,"description":"Style adherence weight (0-1)."},"weirdness_constraint":{"type":"number","maximum":1,"minimum":0,"description":"Weirdness constraint (0-1)."},"audio_weight":{"type":"number","maximum":1,"minimum":0,"description":"Audio weight (0-1)."},"upload_url":{"type":"string","description":"URL of the audio file to cover."},"vocal_mode":{"type":"string","enum":["auto_lyrics","exact_lyrics","instrumental"],"description":"Vocal generation mode."},"prompt":{"type":"string","maxLength":5000,"description":"Cover brief for automatic lyrics."},"lyrics":{"type":"string","maxLength":5000,"description":"Exact cover lyrics to sing."},"style":{"type":"string","maxLength":1000,"description":"Music style."},"title":{"type":"string","maxLength":80,"description":"Music title."},"persona_id":{"type":"string","description":"Persona ID."},"persona_type":{"type":"string","enum":["style","voice"],"description":"Persona type."},"negative_tags":{"type":"string","maxLength":200,"description":"Styles to avoid."}},"additionalProperties":false,"required":["model","upload_url","vocal_mode"],"allOf":[{"if":{"properties":{"vocal_mode":{"const":"auto_lyrics"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["prompt"]},{"not":{"required":["lyrics"]}},{"not":{"required":["style"]}},{"not":{"required":["title"]}}]}},{"if":{"properties":{"vocal_mode":{"const":"exact_lyrics"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["lyrics","style","title"]},{"not":{"required":["prompt"]}}]}},{"if":{"properties":{"vocal_mode":{"const":"instrumental"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["style","title"]},{"not":{"required":["prompt"]}},{"not":{"required":["lyrics"]}}]}}]},{"type":"object","properties":{"callback_url":{"type":"string","description":"Webhook URL for async notifications."},"model":{"type":"string","description":"Model slug.","const":"suno-v6"},"vocal_gender":{"type":"string","enum":["male","female"],"description":"Vocal gender."},"style_weight":{"type":"number","maximum":1,"minimum":0,"description":"Style adherence weight (0-1)."},"weirdness_constraint":{"type":"number","maximum":1,"minimum":0,"description":"Weirdness constraint (0-1)."},"audio_weight":{"type":"number","maximum":1,"minimum":0,"description":"Audio weight (0-1)."},"upload_url":{"type":"string","description":"URL of the audio file to cover."},"vocal_mode":{"type":"string","enum":["auto_lyrics","exact_lyrics","instrumental"],"description":"Vocal generation mode."},"prompt":{"type":"string","maxLength":5000,"description":"Cover brief for automatic lyrics."},"lyrics":{"type":"string","maxLength":5000,"description":"Exact cover lyrics to sing."},"style":{"type":"string","maxLength":1000,"description":"Music style."},"title":{"type":"string","maxLength":80,"description":"Music title."},"persona_id":{"type":"string","description":"Persona ID."},"persona_type":{"type":"string","enum":["style","voice"],"description":"Persona type."},"negative_tags":{"type":"string","maxLength":200,"description":"Styles to avoid."}},"additionalProperties":false,"required":["model","upload_url","vocal_mode"],"allOf":[{"if":{"properties":{"vocal_mode":{"const":"auto_lyrics"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["prompt"]},{"not":{"required":["lyrics"]}},{"not":{"required":["style"]}},{"not":{"required":["title"]}}]}},{"if":{"properties":{"vocal_mode":{"const":"exact_lyrics"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["lyrics","style","title"]},{"not":{"required":["prompt"]}}]}},{"if":{"properties":{"vocal_mode":{"const":"instrumental"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["style","title"]},{"not":{"required":["prompt"]}},{"not":{"required":["lyrics"]}}]}}]},{"type":"object","properties":{"callback_url":{"type":"string","description":"Webhook URL for async notifications."},"model":{"type":"string","description":"Model slug.","const":"suno-v6-mini"},"vocal_gender":{"type":"string","enum":["male","female"],"description":"Vocal gender."},"style_weight":{"type":"number","maximum":1,"minimum":0,"description":"Style adherence weight (0-1)."},"weirdness_constraint":{"type":"number","maximum":1,"minimum":0,"description":"Weirdness constraint (0-1)."},"audio_weight":{"type":"number","maximum":1,"minimum":0,"description":"Audio weight (0-1)."},"upload_url":{"type":"string","description":"URL of the audio file to cover."},"vocal_mode":{"type":"string","enum":["auto_lyrics","exact_lyrics","instrumental"],"description":"Vocal generation mode."},"prompt":{"type":"string","maxLength":5000,"description":"Cover brief for automatic lyrics."},"lyrics":{"type":"string","maxLength":5000,"description":"Exact cover lyrics to sing."},"style":{"type":"string","maxLength":1000,"description":"Music style."},"title":{"type":"string","maxLength":80,"description":"Music title."},"persona_id":{"type":"string","description":"Persona ID."},"persona_type":{"type":"string","enum":["style","voice"],"description":"Persona type."},"negative_tags":{"type":"string","maxLength":200,"description":"Styles to avoid."}},"additionalProperties":false,"required":["model","upload_url","vocal_mode"],"allOf":[{"if":{"properties":{"vocal_mode":{"const":"auto_lyrics"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["prompt"]},{"not":{"required":["lyrics"]}},{"not":{"required":["style"]}},{"not":{"required":["title"]}}]}},{"if":{"properties":{"vocal_mode":{"const":"exact_lyrics"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["lyrics","style","title"]},{"not":{"required":["prompt"]}}]}},{"if":{"properties":{"vocal_mode":{"const":"instrumental"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["style","title"]},{"not":{"required":["prompt"]}},{"not":{"required":["lyrics"]}}]}}]},{"type":"object","properties":{"callback_url":{"type":"string","description":"Webhook URL for async notifications."},"model":{"type":"string","description":"Model slug.","const":"suno-v6-wild"},"vocal_gender":{"type":"string","enum":["male","female"],"description":"Vocal gender."},"style_weight":{"type":"number","maximum":1,"minimum":0,"description":"Style adherence weight (0-1)."},"weirdness_constraint":{"type":"number","maximum":1,"minimum":0,"description":"Weirdness constraint (0-1)."},"audio_weight":{"type":"number","maximum":1,"minimum":0,"description":"Audio weight (0-1)."},"upload_url":{"type":"string","description":"URL of the audio file to cover."},"vocal_mode":{"type":"string","enum":["auto_lyrics","exact_lyrics","instrumental"],"description":"Vocal generation mode."},"prompt":{"type":"string","maxLength":5000,"description":"Cover brief for automatic lyrics."},"lyrics":{"type":"string","maxLength":5000,"description":"Exact cover lyrics to sing."},"style":{"type":"string","maxLength":1000,"description":"Music style."},"title":{"type":"string","maxLength":80,"description":"Music title."},"persona_id":{"type":"string","description":"Persona ID."},"persona_type":{"type":"string","enum":["style","voice"],"description":"Persona type."},"negative_tags":{"type":"string","maxLength":200,"description":"Styles to avoid."}},"additionalProperties":false,"required":["model","upload_url","vocal_mode"],"allOf":[{"if":{"properties":{"vocal_mode":{"const":"auto_lyrics"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["prompt"]},{"not":{"required":["lyrics"]}},{"not":{"required":["style"]}},{"not":{"required":["title"]}}]}},{"if":{"properties":{"vocal_mode":{"const":"exact_lyrics"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["lyrics","style","title"]},{"not":{"required":["prompt"]}}]}},{"if":{"properties":{"vocal_mode":{"const":"instrumental"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["style","title"]},{"not":{"required":["prompt"]}},{"not":{"required":["lyrics"]}}]}}]}]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/suno/cover_audio/{id}":{"get":{"tags":["Suno"],"summary":"Retrieve Suno Cover-Audio task","description":"Create an asynchronous task through the Suno cover audio endpoint.","operationId":"task_endpoint_suno_cover_audio_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"generation_stage":{"type":"string","enum":["text_generated","first_audio_ready"]},"audios":{"type":"array","items":{"type":"object","required":["id"],"properties":{"id":{"type":"string"},"audio_url":{"type":"string","x-runapi-generated-media":true},"stream_audio_url":{"type":"string","x-runapi-generated-media":true},"image_url":{"type":"string","x-runapi-generated-media":true},"lyrics":{"type":"string"},"model_name":{"type":"string"},"title":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"duration":{"type":"number"}},"unevaluatedProperties":false}}},"unevaluatedProperties":false},{"type":"object","required":["id","status","audios","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"generation_stage":{"type":"string","enum":["text_generated","first_audio_ready","all_audios_ready","failed"]},"audios":{"type":"array","items":{"type":"object","required":["id"],"properties":{"id":{"type":"string"},"audio_url":{"type":"string","x-runapi-generated-media":true},"stream_audio_url":{"type":"string","x-runapi-generated-media":true},"image_url":{"type":"string","x-runapi-generated-media":true},"lyrics":{"type":"string"},"model_name":{"type":"string"},"title":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"duration":{"type":"number"}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/suno/create_mashup":{"post":{"tags":["Suno"],"summary":"Suno Create-Mashup","description":"Create an asynchronous task through the Suno create mashup endpoint.","operationId":"task_endpoint_suno_create_mashup","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"callback_url":{"type":"string","description":"Webhook URL for async notifications."},"model":{"type":"string","description":"Model slug.","const":"suno-v4"},"vocal_gender":{"type":"string","enum":["male","female"],"description":"Vocal gender."},"style_weight":{"type":"number","maximum":1,"minimum":0,"description":"Style adherence weight (0-1)."},"weirdness_constraint":{"type":"number","maximum":1,"minimum":0,"description":"Weirdness constraint (0-1)."},"audio_weight":{"type":"number","maximum":1,"minimum":0,"description":"Audio weight (0-1)."},"upload_url_list":{"type":"array","maxItems":2,"minItems":2,"description":"Two audio URLs to mashup."},"vocal_mode":{"type":"string","enum":["auto_lyrics","exact_lyrics","instrumental"],"description":"Vocal generation mode."},"prompt":{"type":"string","maxLength":5000,"description":"Mashup brief for automatic lyrics."},"lyrics":{"type":"string","maxLength":5000,"description":"Exact mashup lyrics to sing."},"style":{"type":"string","maxLength":1000,"description":"Music style."},"title":{"type":"string","maxLength":80,"description":"Music title."},"persona_id":{"type":"string","description":"Persona ID."},"persona_type":{"type":"string","enum":["style","voice"],"description":"Persona type."}},"additionalProperties":false,"required":["model","upload_url_list","vocal_mode"],"allOf":[{"if":{"properties":{"vocal_mode":{"const":"auto_lyrics"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["prompt"]},{"not":{"required":["lyrics"]}},{"not":{"required":["style"]}},{"not":{"required":["title"]}}]}},{"if":{"properties":{"vocal_mode":{"const":"exact_lyrics"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["lyrics","style","title"]},{"not":{"required":["prompt"]}}]}},{"if":{"properties":{"vocal_mode":{"const":"instrumental"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["style","title"]},{"not":{"required":["prompt"]}},{"not":{"required":["lyrics"]}}]}}]},{"type":"object","properties":{"callback_url":{"type":"string","description":"Webhook URL for async notifications."},"model":{"type":"string","description":"Model slug.","const":"suno-v4.5"},"vocal_gender":{"type":"string","enum":["male","female"],"description":"Vocal gender."},"style_weight":{"type":"number","maximum":1,"minimum":0,"description":"Style adherence weight (0-1)."},"weirdness_constraint":{"type":"number","maximum":1,"minimum":0,"description":"Weirdness constraint (0-1)."},"audio_weight":{"type":"number","maximum":1,"minimum":0,"description":"Audio weight (0-1)."},"upload_url_list":{"type":"array","maxItems":2,"minItems":2,"description":"Two audio URLs to mashup."},"vocal_mode":{"type":"string","enum":["auto_lyrics","exact_lyrics","instrumental"],"description":"Vocal generation mode."},"prompt":{"type":"string","maxLength":5000,"description":"Mashup brief for automatic lyrics."},"lyrics":{"type":"string","maxLength":5000,"description":"Exact mashup lyrics to sing."},"style":{"type":"string","maxLength":1000,"description":"Music style."},"title":{"type":"string","maxLength":80,"description":"Music title."},"persona_id":{"type":"string","description":"Persona ID."},"persona_type":{"type":"string","enum":["style","voice"],"description":"Persona type."}},"additionalProperties":false,"required":["model","upload_url_list","vocal_mode"],"allOf":[{"if":{"properties":{"vocal_mode":{"const":"auto_lyrics"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["prompt"]},{"not":{"required":["lyrics"]}},{"not":{"required":["style"]}},{"not":{"required":["title"]}}]}},{"if":{"properties":{"vocal_mode":{"const":"exact_lyrics"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["lyrics","style","title"]},{"not":{"required":["prompt"]}}]}},{"if":{"properties":{"vocal_mode":{"const":"instrumental"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["style","title"]},{"not":{"required":["prompt"]}},{"not":{"required":["lyrics"]}}]}}]},{"type":"object","properties":{"callback_url":{"type":"string","description":"Webhook URL for async notifications."},"model":{"type":"string","description":"Model slug.","const":"suno-v4.5-all"},"vocal_gender":{"type":"string","enum":["male","female"],"description":"Vocal gender."},"style_weight":{"type":"number","maximum":1,"minimum":0,"description":"Style adherence weight (0-1)."},"weirdness_constraint":{"type":"number","maximum":1,"minimum":0,"description":"Weirdness constraint (0-1)."},"audio_weight":{"type":"number","maximum":1,"minimum":0,"description":"Audio weight (0-1)."},"upload_url_list":{"type":"array","maxItems":2,"minItems":2,"description":"Two audio URLs to mashup."},"vocal_mode":{"type":"string","enum":["auto_lyrics","exact_lyrics","instrumental"],"description":"Vocal generation mode."},"prompt":{"type":"string","maxLength":5000,"description":"Mashup brief for automatic lyrics."},"lyrics":{"type":"string","maxLength":5000,"description":"Exact mashup lyrics to sing."},"style":{"type":"string","maxLength":1000,"description":"Music style."},"title":{"type":"string","maxLength":80,"description":"Music title."},"persona_id":{"type":"string","description":"Persona ID."},"persona_type":{"type":"string","enum":["style","voice"],"description":"Persona type."}},"additionalProperties":false,"required":["model","upload_url_list","vocal_mode"],"allOf":[{"if":{"properties":{"vocal_mode":{"const":"auto_lyrics"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["prompt"]},{"not":{"required":["lyrics"]}},{"not":{"required":["style"]}},{"not":{"required":["title"]}}]}},{"if":{"properties":{"vocal_mode":{"const":"exact_lyrics"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["lyrics","style","title"]},{"not":{"required":["prompt"]}}]}},{"if":{"properties":{"vocal_mode":{"const":"instrumental"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["style","title"]},{"not":{"required":["prompt"]}},{"not":{"required":["lyrics"]}}]}}]},{"type":"object","properties":{"callback_url":{"type":"string","description":"Webhook URL for async notifications."},"model":{"type":"string","description":"Model slug.","const":"suno-v4.5-plus"},"vocal_gender":{"type":"string","enum":["male","female"],"description":"Vocal gender."},"style_weight":{"type":"number","maximum":1,"minimum":0,"description":"Style adherence weight (0-1)."},"weirdness_constraint":{"type":"number","maximum":1,"minimum":0,"description":"Weirdness constraint (0-1)."},"audio_weight":{"type":"number","maximum":1,"minimum":0,"description":"Audio weight (0-1)."},"upload_url_list":{"type":"array","maxItems":2,"minItems":2,"description":"Two audio URLs to mashup."},"vocal_mode":{"type":"string","enum":["auto_lyrics","exact_lyrics","instrumental"],"description":"Vocal generation mode."},"prompt":{"type":"string","maxLength":5000,"description":"Mashup brief for automatic lyrics."},"lyrics":{"type":"string","maxLength":5000,"description":"Exact mashup lyrics to sing."},"style":{"type":"string","maxLength":1000,"description":"Music style."},"title":{"type":"string","maxLength":80,"description":"Music title."},"persona_id":{"type":"string","description":"Persona ID."},"persona_type":{"type":"string","enum":["style","voice"],"description":"Persona type."}},"additionalProperties":false,"required":["model","upload_url_list","vocal_mode"],"allOf":[{"if":{"properties":{"vocal_mode":{"const":"auto_lyrics"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["prompt"]},{"not":{"required":["lyrics"]}},{"not":{"required":["style"]}},{"not":{"required":["title"]}}]}},{"if":{"properties":{"vocal_mode":{"const":"exact_lyrics"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["lyrics","style","title"]},{"not":{"required":["prompt"]}}]}},{"if":{"properties":{"vocal_mode":{"const":"instrumental"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["style","title"]},{"not":{"required":["prompt"]}},{"not":{"required":["lyrics"]}}]}}]},{"type":"object","properties":{"callback_url":{"type":"string","description":"Webhook URL for async notifications."},"model":{"type":"string","description":"Model slug.","const":"suno-v5"},"vocal_gender":{"type":"string","enum":["male","female"],"description":"Vocal gender."},"style_weight":{"type":"number","maximum":1,"minimum":0,"description":"Style adherence weight (0-1)."},"weirdness_constraint":{"type":"number","maximum":1,"minimum":0,"description":"Weirdness constraint (0-1)."},"audio_weight":{"type":"number","maximum":1,"minimum":0,"description":"Audio weight (0-1)."},"upload_url_list":{"type":"array","maxItems":2,"minItems":2,"description":"Two audio URLs to mashup."},"vocal_mode":{"type":"string","enum":["auto_lyrics","exact_lyrics","instrumental"],"description":"Vocal generation mode."},"prompt":{"type":"string","maxLength":5000,"description":"Mashup brief for automatic lyrics."},"lyrics":{"type":"string","maxLength":5000,"description":"Exact mashup lyrics to sing."},"style":{"type":"string","maxLength":1000,"description":"Music style."},"title":{"type":"string","maxLength":80,"description":"Music title."},"persona_id":{"type":"string","description":"Persona ID."},"persona_type":{"type":"string","enum":["style","voice"],"description":"Persona type."}},"additionalProperties":false,"required":["model","upload_url_list","vocal_mode"],"allOf":[{"if":{"properties":{"vocal_mode":{"const":"auto_lyrics"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["prompt"]},{"not":{"required":["lyrics"]}},{"not":{"required":["style"]}},{"not":{"required":["title"]}}]}},{"if":{"properties":{"vocal_mode":{"const":"exact_lyrics"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["lyrics","style","title"]},{"not":{"required":["prompt"]}}]}},{"if":{"properties":{"vocal_mode":{"const":"instrumental"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["style","title"]},{"not":{"required":["prompt"]}},{"not":{"required":["lyrics"]}}]}}]},{"type":"object","properties":{"callback_url":{"type":"string","description":"Webhook URL for async notifications."},"model":{"type":"string","description":"Model slug.","const":"suno-v5.5"},"vocal_gender":{"type":"string","enum":["male","female"],"description":"Vocal gender."},"style_weight":{"type":"number","maximum":1,"minimum":0,"description":"Style adherence weight (0-1)."},"weirdness_constraint":{"type":"number","maximum":1,"minimum":0,"description":"Weirdness constraint (0-1)."},"audio_weight":{"type":"number","maximum":1,"minimum":0,"description":"Audio weight (0-1)."},"upload_url_list":{"type":"array","maxItems":2,"minItems":2,"description":"Two audio URLs to mashup."},"vocal_mode":{"type":"string","enum":["auto_lyrics","exact_lyrics","instrumental"],"description":"Vocal generation mode."},"prompt":{"type":"string","maxLength":5000,"description":"Mashup brief for automatic lyrics."},"lyrics":{"type":"string","maxLength":5000,"description":"Exact mashup lyrics to sing."},"style":{"type":"string","maxLength":1000,"description":"Music style."},"title":{"type":"string","maxLength":80,"description":"Music title."},"persona_id":{"type":"string","description":"Persona ID."},"persona_type":{"type":"string","enum":["style","voice"],"description":"Persona type."}},"additionalProperties":false,"required":["model","upload_url_list","vocal_mode"],"allOf":[{"if":{"properties":{"vocal_mode":{"const":"auto_lyrics"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["prompt"]},{"not":{"required":["lyrics"]}},{"not":{"required":["style"]}},{"not":{"required":["title"]}}]}},{"if":{"properties":{"vocal_mode":{"const":"exact_lyrics"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["lyrics","style","title"]},{"not":{"required":["prompt"]}}]}},{"if":{"properties":{"vocal_mode":{"const":"instrumental"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["style","title"]},{"not":{"required":["prompt"]}},{"not":{"required":["lyrics"]}}]}}]},{"type":"object","properties":{"callback_url":{"type":"string","description":"Webhook URL for async notifications."},"model":{"type":"string","description":"Model slug.","const":"suno-v6"},"vocal_gender":{"type":"string","enum":["male","female"],"description":"Vocal gender."},"style_weight":{"type":"number","maximum":1,"minimum":0,"description":"Style adherence weight (0-1)."},"weirdness_constraint":{"type":"number","maximum":1,"minimum":0,"description":"Weirdness constraint (0-1)."},"audio_weight":{"type":"number","maximum":1,"minimum":0,"description":"Audio weight (0-1)."},"upload_url_list":{"type":"array","maxItems":2,"minItems":2,"description":"Two audio URLs to mashup."},"vocal_mode":{"type":"string","enum":["auto_lyrics","exact_lyrics","instrumental"],"description":"Vocal generation mode."},"prompt":{"type":"string","maxLength":5000,"description":"Mashup brief for automatic lyrics."},"lyrics":{"type":"string","maxLength":5000,"description":"Exact mashup lyrics to sing."},"style":{"type":"string","maxLength":1000,"description":"Music style."},"title":{"type":"string","maxLength":80,"description":"Music title."},"persona_id":{"type":"string","description":"Persona ID."},"persona_type":{"type":"string","enum":["style","voice"],"description":"Persona type."}},"additionalProperties":false,"required":["model","upload_url_list","vocal_mode"],"allOf":[{"if":{"properties":{"vocal_mode":{"const":"auto_lyrics"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["prompt"]},{"not":{"required":["lyrics"]}},{"not":{"required":["style"]}},{"not":{"required":["title"]}}]}},{"if":{"properties":{"vocal_mode":{"const":"exact_lyrics"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["lyrics","style","title"]},{"not":{"required":["prompt"]}}]}},{"if":{"properties":{"vocal_mode":{"const":"instrumental"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["style","title"]},{"not":{"required":["prompt"]}},{"not":{"required":["lyrics"]}}]}}]},{"type":"object","properties":{"callback_url":{"type":"string","description":"Webhook URL for async notifications."},"model":{"type":"string","description":"Model slug.","const":"suno-v6-mini"},"vocal_gender":{"type":"string","enum":["male","female"],"description":"Vocal gender."},"style_weight":{"type":"number","maximum":1,"minimum":0,"description":"Style adherence weight (0-1)."},"weirdness_constraint":{"type":"number","maximum":1,"minimum":0,"description":"Weirdness constraint (0-1)."},"audio_weight":{"type":"number","maximum":1,"minimum":0,"description":"Audio weight (0-1)."},"upload_url_list":{"type":"array","maxItems":2,"minItems":2,"description":"Two audio URLs to mashup."},"vocal_mode":{"type":"string","enum":["auto_lyrics","exact_lyrics","instrumental"],"description":"Vocal generation mode."},"prompt":{"type":"string","maxLength":5000,"description":"Mashup brief for automatic lyrics."},"lyrics":{"type":"string","maxLength":5000,"description":"Exact mashup lyrics to sing."},"style":{"type":"string","maxLength":1000,"description":"Music style."},"title":{"type":"string","maxLength":80,"description":"Music title."},"persona_id":{"type":"string","description":"Persona ID."},"persona_type":{"type":"string","enum":["style","voice"],"description":"Persona type."}},"additionalProperties":false,"required":["model","upload_url_list","vocal_mode"],"allOf":[{"if":{"properties":{"vocal_mode":{"const":"auto_lyrics"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["prompt"]},{"not":{"required":["lyrics"]}},{"not":{"required":["style"]}},{"not":{"required":["title"]}}]}},{"if":{"properties":{"vocal_mode":{"const":"exact_lyrics"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["lyrics","style","title"]},{"not":{"required":["prompt"]}}]}},{"if":{"properties":{"vocal_mode":{"const":"instrumental"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["style","title"]},{"not":{"required":["prompt"]}},{"not":{"required":["lyrics"]}}]}}]},{"type":"object","properties":{"callback_url":{"type":"string","description":"Webhook URL for async notifications."},"model":{"type":"string","description":"Model slug.","const":"suno-v6-wild"},"vocal_gender":{"type":"string","enum":["male","female"],"description":"Vocal gender."},"style_weight":{"type":"number","maximum":1,"minimum":0,"description":"Style adherence weight (0-1)."},"weirdness_constraint":{"type":"number","maximum":1,"minimum":0,"description":"Weirdness constraint (0-1)."},"audio_weight":{"type":"number","maximum":1,"minimum":0,"description":"Audio weight (0-1)."},"upload_url_list":{"type":"array","maxItems":2,"minItems":2,"description":"Two audio URLs to mashup."},"vocal_mode":{"type":"string","enum":["auto_lyrics","exact_lyrics","instrumental"],"description":"Vocal generation mode."},"prompt":{"type":"string","maxLength":5000,"description":"Mashup brief for automatic lyrics."},"lyrics":{"type":"string","maxLength":5000,"description":"Exact mashup lyrics to sing."},"style":{"type":"string","maxLength":1000,"description":"Music style."},"title":{"type":"string","maxLength":80,"description":"Music title."},"persona_id":{"type":"string","description":"Persona ID."},"persona_type":{"type":"string","enum":["style","voice"],"description":"Persona type."}},"additionalProperties":false,"required":["model","upload_url_list","vocal_mode"],"allOf":[{"if":{"properties":{"vocal_mode":{"const":"auto_lyrics"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["prompt"]},{"not":{"required":["lyrics"]}},{"not":{"required":["style"]}},{"not":{"required":["title"]}}]}},{"if":{"properties":{"vocal_mode":{"const":"exact_lyrics"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["lyrics","style","title"]},{"not":{"required":["prompt"]}}]}},{"if":{"properties":{"vocal_mode":{"const":"instrumental"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["style","title"]},{"not":{"required":["prompt"]}},{"not":{"required":["lyrics"]}}]}}]}]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/suno/create_mashup/{id}":{"get":{"tags":["Suno"],"summary":"Retrieve Suno Create-Mashup task","description":"Create an asynchronous task through the Suno create mashup endpoint.","operationId":"task_endpoint_suno_create_mashup_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"generation_stage":{"type":"string","enum":["text_generated","first_audio_ready"]},"audios":{"type":"array","items":{"type":"object","required":["id"],"properties":{"id":{"type":"string"},"audio_url":{"type":"string","x-runapi-generated-media":true},"stream_audio_url":{"type":"string","x-runapi-generated-media":true},"image_url":{"type":"string","x-runapi-generated-media":true},"lyrics":{"type":"string"},"model_name":{"type":"string"},"title":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"duration":{"type":"number"}},"unevaluatedProperties":false}}},"unevaluatedProperties":false},{"type":"object","required":["id","status","audios","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"generation_stage":{"type":"string","enum":["text_generated","first_audio_ready","all_audios_ready","failed"]},"audios":{"type":"array","items":{"type":"object","required":["id"],"properties":{"id":{"type":"string"},"audio_url":{"type":"string","x-runapi-generated-media":true},"stream_audio_url":{"type":"string","x-runapi-generated-media":true},"image_url":{"type":"string","x-runapi-generated-media":true},"lyrics":{"type":"string"},"model_name":{"type":"string"},"title":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"duration":{"type":"number"}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/suno/extend_music":{"post":{"tags":["Suno"],"summary":"Suno Extend-Music","description":"Create an asynchronous task through the Suno extend music endpoint.","operationId":"task_endpoint_suno_extend_music","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"callback_url":{"type":"string","description":"Webhook URL for async notifications."},"model":{"type":"string","description":"Model slug.","const":"suno-v4"},"vocal_gender":{"type":"string","enum":["male","female"],"description":"Vocal gender."},"style_weight":{"type":"number","maximum":1,"minimum":0,"description":"Style adherence weight (0-1)."},"weirdness_constraint":{"type":"number","maximum":1,"minimum":0,"description":"Weirdness constraint (0-1)."},"audio_weight":{"type":"number","maximum":1,"minimum":0,"description":"Audio weight (0-1)."},"task_id":{"type":"string","description":"Source task ID to extend. Provide one of task_id, audio_id, audio_url, or upload_url."},"audio_id":{"type":"string","description":"Source audio ID to extend. Provide one of task_id, audio_id, audio_url, or upload_url."},"audio_url":{"type":"string","description":"Source audio URL to extend. Provide one of task_id, audio_id, audio_url, or upload_url."},"upload_url":{"type":"string","description":"Uploaded source audio URL to extend. Provide one of task_id, audio_id, audio_url, or upload_url."},"parameter_mode":{"type":"string","enum":["source","custom"],"description":"Inherit the source track's parameters (source) or supply custom ones (custom)."},"instrumental":{"type":"boolean","description":"When true, generate without vocals."},"prompt":{"type":"string","maxLength":5000,"description":"Extension brief. Cannot be combined with lyrics."},"lyrics":{"type":"string","maxLength":5000,"description":"Exact lyrics. Only allowed when extending uploaded audio in custom parameter mode."},"style":{"type":"string","maxLength":1000,"description":"Style preset. Required in custom parameter mode."},"title":{"type":"string","maxLength":80,"description":"Song title. Required in custom parameter mode."},"continue_at":{"type":"number","description":"Seconds into the source to continue from. Required in custom parameter mode."},"persona_id":{"type":"string","description":"Persona ID."},"persona_type":{"type":"string","enum":["style","voice"],"description":"Persona type."},"negative_tags":{"type":"string","maxLength":200,"description":"Styles to avoid."}},"additionalProperties":false,"required":["model","parameter_mode"]},{"type":"object","properties":{"callback_url":{"type":"string","description":"Webhook URL for async notifications."},"model":{"type":"string","description":"Model slug.","const":"suno-v4.5"},"vocal_gender":{"type":"string","enum":["male","female"],"description":"Vocal gender."},"style_weight":{"type":"number","maximum":1,"minimum":0,"description":"Style adherence weight (0-1)."},"weirdness_constraint":{"type":"number","maximum":1,"minimum":0,"description":"Weirdness constraint (0-1)."},"audio_weight":{"type":"number","maximum":1,"minimum":0,"description":"Audio weight (0-1)."},"task_id":{"type":"string","description":"Source task ID to extend. Provide one of task_id, audio_id, audio_url, or upload_url."},"audio_id":{"type":"string","description":"Source audio ID to extend. Provide one of task_id, audio_id, audio_url, or upload_url."},"audio_url":{"type":"string","description":"Source audio URL to extend. Provide one of task_id, audio_id, audio_url, or upload_url."},"upload_url":{"type":"string","description":"Uploaded source audio URL to extend. Provide one of task_id, audio_id, audio_url, or upload_url."},"parameter_mode":{"type":"string","enum":["source","custom"],"description":"Inherit the source track's parameters (source) or supply custom ones (custom)."},"instrumental":{"type":"boolean","description":"When true, generate without vocals."},"prompt":{"type":"string","maxLength":5000,"description":"Extension brief. Cannot be combined with lyrics."},"lyrics":{"type":"string","maxLength":5000,"description":"Exact lyrics. Only allowed when extending uploaded audio in custom parameter mode."},"style":{"type":"string","maxLength":1000,"description":"Style preset. Required in custom parameter mode."},"title":{"type":"string","maxLength":80,"description":"Song title. Required in custom parameter mode."},"continue_at":{"type":"number","description":"Seconds into the source to continue from. Required in custom parameter mode."},"persona_id":{"type":"string","description":"Persona ID."},"persona_type":{"type":"string","enum":["style","voice"],"description":"Persona type."},"negative_tags":{"type":"string","maxLength":200,"description":"Styles to avoid."}},"additionalProperties":false,"required":["model","parameter_mode"]},{"type":"object","properties":{"callback_url":{"type":"string","description":"Webhook URL for async notifications."},"model":{"type":"string","description":"Model slug.","const":"suno-v4.5-all"},"vocal_gender":{"type":"string","enum":["male","female"],"description":"Vocal gender."},"style_weight":{"type":"number","maximum":1,"minimum":0,"description":"Style adherence weight (0-1)."},"weirdness_constraint":{"type":"number","maximum":1,"minimum":0,"description":"Weirdness constraint (0-1)."},"audio_weight":{"type":"number","maximum":1,"minimum":0,"description":"Audio weight (0-1)."},"task_id":{"type":"string","description":"Source task ID to extend. Provide one of task_id, audio_id, audio_url, or upload_url."},"audio_id":{"type":"string","description":"Source audio ID to extend. Provide one of task_id, audio_id, audio_url, or upload_url."},"audio_url":{"type":"string","description":"Source audio URL to extend. Provide one of task_id, audio_id, audio_url, or upload_url."},"upload_url":{"type":"string","description":"Uploaded source audio URL to extend. Provide one of task_id, audio_id, audio_url, or upload_url."},"parameter_mode":{"type":"string","enum":["source","custom"],"description":"Inherit the source track's parameters (source) or supply custom ones (custom)."},"instrumental":{"type":"boolean","description":"When true, generate without vocals."},"prompt":{"type":"string","maxLength":5000,"description":"Extension brief. Cannot be combined with lyrics."},"lyrics":{"type":"string","maxLength":5000,"description":"Exact lyrics. Only allowed when extending uploaded audio in custom parameter mode."},"style":{"type":"string","maxLength":1000,"description":"Style preset. Required in custom parameter mode."},"title":{"type":"string","maxLength":80,"description":"Song title. Required in custom parameter mode."},"continue_at":{"type":"number","description":"Seconds into the source to continue from. Required in custom parameter mode."},"persona_id":{"type":"string","description":"Persona ID."},"persona_type":{"type":"string","enum":["style","voice"],"description":"Persona type."},"negative_tags":{"type":"string","maxLength":200,"description":"Styles to avoid."}},"additionalProperties":false,"required":["model","parameter_mode"]},{"type":"object","properties":{"callback_url":{"type":"string","description":"Webhook URL for async notifications."},"model":{"type":"string","description":"Model slug.","const":"suno-v4.5-plus"},"vocal_gender":{"type":"string","enum":["male","female"],"description":"Vocal gender."},"style_weight":{"type":"number","maximum":1,"minimum":0,"description":"Style adherence weight (0-1)."},"weirdness_constraint":{"type":"number","maximum":1,"minimum":0,"description":"Weirdness constraint (0-1)."},"audio_weight":{"type":"number","maximum":1,"minimum":0,"description":"Audio weight (0-1)."},"task_id":{"type":"string","description":"Source task ID to extend. Provide one of task_id, audio_id, audio_url, or upload_url."},"audio_id":{"type":"string","description":"Source audio ID to extend. Provide one of task_id, audio_id, audio_url, or upload_url."},"audio_url":{"type":"string","description":"Source audio URL to extend. Provide one of task_id, audio_id, audio_url, or upload_url."},"upload_url":{"type":"string","description":"Uploaded source audio URL to extend. Provide one of task_id, audio_id, audio_url, or upload_url."},"parameter_mode":{"type":"string","enum":["source","custom"],"description":"Inherit the source track's parameters (source) or supply custom ones (custom)."},"instrumental":{"type":"boolean","description":"When true, generate without vocals."},"prompt":{"type":"string","maxLength":5000,"description":"Extension brief. Cannot be combined with lyrics."},"lyrics":{"type":"string","maxLength":5000,"description":"Exact lyrics. Only allowed when extending uploaded audio in custom parameter mode."},"style":{"type":"string","maxLength":1000,"description":"Style preset. Required in custom parameter mode."},"title":{"type":"string","maxLength":80,"description":"Song title. Required in custom parameter mode."},"continue_at":{"type":"number","description":"Seconds into the source to continue from. Required in custom parameter mode."},"persona_id":{"type":"string","description":"Persona ID."},"persona_type":{"type":"string","enum":["style","voice"],"description":"Persona type."},"negative_tags":{"type":"string","maxLength":200,"description":"Styles to avoid."}},"additionalProperties":false,"required":["model","parameter_mode"]},{"type":"object","properties":{"callback_url":{"type":"string","description":"Webhook URL for async notifications."},"model":{"type":"string","description":"Model slug.","const":"suno-v5"},"vocal_gender":{"type":"string","enum":["male","female"],"description":"Vocal gender."},"style_weight":{"type":"number","maximum":1,"minimum":0,"description":"Style adherence weight (0-1)."},"weirdness_constraint":{"type":"number","maximum":1,"minimum":0,"description":"Weirdness constraint (0-1)."},"audio_weight":{"type":"number","maximum":1,"minimum":0,"description":"Audio weight (0-1)."},"task_id":{"type":"string","description":"Source task ID to extend. Provide one of task_id, audio_id, audio_url, or upload_url."},"audio_id":{"type":"string","description":"Source audio ID to extend. Provide one of task_id, audio_id, audio_url, or upload_url."},"audio_url":{"type":"string","description":"Source audio URL to extend. Provide one of task_id, audio_id, audio_url, or upload_url."},"upload_url":{"type":"string","description":"Uploaded source audio URL to extend. Provide one of task_id, audio_id, audio_url, or upload_url."},"parameter_mode":{"type":"string","enum":["source","custom"],"description":"Inherit the source track's parameters (source) or supply custom ones (custom)."},"instrumental":{"type":"boolean","description":"When true, generate without vocals."},"prompt":{"type":"string","maxLength":5000,"description":"Extension brief. Cannot be combined with lyrics."},"lyrics":{"type":"string","maxLength":5000,"description":"Exact lyrics. Only allowed when extending uploaded audio in custom parameter mode."},"style":{"type":"string","maxLength":1000,"description":"Style preset. Required in custom parameter mode."},"title":{"type":"string","maxLength":80,"description":"Song title. Required in custom parameter mode."},"continue_at":{"type":"number","description":"Seconds into the source to continue from. Required in custom parameter mode."},"persona_id":{"type":"string","description":"Persona ID."},"persona_type":{"type":"string","enum":["style","voice"],"description":"Persona type."},"negative_tags":{"type":"string","maxLength":200,"description":"Styles to avoid."}},"additionalProperties":false,"required":["model","parameter_mode"]},{"type":"object","properties":{"callback_url":{"type":"string","description":"Webhook URL for async notifications."},"model":{"type":"string","description":"Model slug.","const":"suno-v5.5"},"vocal_gender":{"type":"string","enum":["male","female"],"description":"Vocal gender."},"style_weight":{"type":"number","maximum":1,"minimum":0,"description":"Style adherence weight (0-1)."},"weirdness_constraint":{"type":"number","maximum":1,"minimum":0,"description":"Weirdness constraint (0-1)."},"audio_weight":{"type":"number","maximum":1,"minimum":0,"description":"Audio weight (0-1)."},"task_id":{"type":"string","description":"Source task ID to extend. Provide one of task_id, audio_id, audio_url, or upload_url."},"audio_id":{"type":"string","description":"Source audio ID to extend. Provide one of task_id, audio_id, audio_url, or upload_url."},"audio_url":{"type":"string","description":"Source audio URL to extend. Provide one of task_id, audio_id, audio_url, or upload_url."},"upload_url":{"type":"string","description":"Uploaded source audio URL to extend. Provide one of task_id, audio_id, audio_url, or upload_url."},"parameter_mode":{"type":"string","enum":["source","custom"],"description":"Inherit the source track's parameters (source) or supply custom ones (custom)."},"instrumental":{"type":"boolean","description":"When true, generate without vocals."},"prompt":{"type":"string","maxLength":5000,"description":"Extension brief. Cannot be combined with lyrics."},"lyrics":{"type":"string","maxLength":5000,"description":"Exact lyrics. Only allowed when extending uploaded audio in custom parameter mode."},"style":{"type":"string","maxLength":1000,"description":"Style preset. Required in custom parameter mode."},"title":{"type":"string","maxLength":80,"description":"Song title. Required in custom parameter mode."},"continue_at":{"type":"number","description":"Seconds into the source to continue from. Required in custom parameter mode."},"persona_id":{"type":"string","description":"Persona ID."},"persona_type":{"type":"string","enum":["style","voice"],"description":"Persona type."},"negative_tags":{"type":"string","maxLength":200,"description":"Styles to avoid."}},"additionalProperties":false,"required":["model","parameter_mode"]},{"type":"object","properties":{"callback_url":{"type":"string","description":"Webhook URL for async notifications."},"model":{"type":"string","description":"Model slug.","const":"suno-v6"},"vocal_gender":{"type":"string","enum":["male","female"],"description":"Vocal gender."},"style_weight":{"type":"number","maximum":1,"minimum":0,"description":"Style adherence weight (0-1)."},"weirdness_constraint":{"type":"number","maximum":1,"minimum":0,"description":"Weirdness constraint (0-1)."},"audio_weight":{"type":"number","maximum":1,"minimum":0,"description":"Audio weight (0-1)."},"task_id":{"type":"string","description":"Source task ID to extend. Provide one of task_id, audio_id, audio_url, or upload_url."},"audio_id":{"type":"string","description":"Source audio ID to extend. Provide one of task_id, audio_id, audio_url, or upload_url."},"audio_url":{"type":"string","description":"Source audio URL to extend. Provide one of task_id, audio_id, audio_url, or upload_url."},"upload_url":{"type":"string","description":"Uploaded source audio URL to extend. Provide one of task_id, audio_id, audio_url, or upload_url."},"parameter_mode":{"type":"string","enum":["source","custom"],"description":"Inherit the source track's parameters (source) or supply custom ones (custom)."},"instrumental":{"type":"boolean","description":"When true, generate without vocals."},"prompt":{"type":"string","maxLength":5000,"description":"Extension brief. Cannot be combined with lyrics."},"lyrics":{"type":"string","maxLength":5000,"description":"Exact lyrics. Only allowed when extending uploaded audio in custom parameter mode."},"style":{"type":"string","maxLength":1000,"description":"Style preset. Required in custom parameter mode."},"title":{"type":"string","maxLength":80,"description":"Song title. Required in custom parameter mode."},"continue_at":{"type":"number","description":"Seconds into the source to continue from. Required in custom parameter mode."},"persona_id":{"type":"string","description":"Persona ID."},"persona_type":{"type":"string","enum":["style","voice"],"description":"Persona type."},"negative_tags":{"type":"string","maxLength":200,"description":"Styles to avoid."}},"additionalProperties":false,"required":["model","parameter_mode"]},{"type":"object","properties":{"callback_url":{"type":"string","description":"Webhook URL for async notifications."},"model":{"type":"string","description":"Model slug.","const":"suno-v6-mini"},"vocal_gender":{"type":"string","enum":["male","female"],"description":"Vocal gender."},"style_weight":{"type":"number","maximum":1,"minimum":0,"description":"Style adherence weight (0-1)."},"weirdness_constraint":{"type":"number","maximum":1,"minimum":0,"description":"Weirdness constraint (0-1)."},"audio_weight":{"type":"number","maximum":1,"minimum":0,"description":"Audio weight (0-1)."},"task_id":{"type":"string","description":"Source task ID to extend. Provide one of task_id, audio_id, audio_url, or upload_url."},"audio_id":{"type":"string","description":"Source audio ID to extend. Provide one of task_id, audio_id, audio_url, or upload_url."},"audio_url":{"type":"string","description":"Source audio URL to extend. Provide one of task_id, audio_id, audio_url, or upload_url."},"upload_url":{"type":"string","description":"Uploaded source audio URL to extend. Provide one of task_id, audio_id, audio_url, or upload_url."},"parameter_mode":{"type":"string","enum":["source","custom"],"description":"Inherit the source track's parameters (source) or supply custom ones (custom)."},"instrumental":{"type":"boolean","description":"When true, generate without vocals."},"prompt":{"type":"string","maxLength":5000,"description":"Extension brief. Cannot be combined with lyrics."},"lyrics":{"type":"string","maxLength":5000,"description":"Exact lyrics. Only allowed when extending uploaded audio in custom parameter mode."},"style":{"type":"string","maxLength":1000,"description":"Style preset. Required in custom parameter mode."},"title":{"type":"string","maxLength":80,"description":"Song title. Required in custom parameter mode."},"continue_at":{"type":"number","description":"Seconds into the source to continue from. Required in custom parameter mode."},"persona_id":{"type":"string","description":"Persona ID."},"persona_type":{"type":"string","enum":["style","voice"],"description":"Persona type."},"negative_tags":{"type":"string","maxLength":200,"description":"Styles to avoid."}},"additionalProperties":false,"required":["model","parameter_mode"]},{"type":"object","properties":{"callback_url":{"type":"string","description":"Webhook URL for async notifications."},"model":{"type":"string","description":"Model slug.","const":"suno-v6-wild"},"vocal_gender":{"type":"string","enum":["male","female"],"description":"Vocal gender."},"style_weight":{"type":"number","maximum":1,"minimum":0,"description":"Style adherence weight (0-1)."},"weirdness_constraint":{"type":"number","maximum":1,"minimum":0,"description":"Weirdness constraint (0-1)."},"audio_weight":{"type":"number","maximum":1,"minimum":0,"description":"Audio weight (0-1)."},"task_id":{"type":"string","description":"Source task ID to extend. Provide one of task_id, audio_id, audio_url, or upload_url."},"audio_id":{"type":"string","description":"Source audio ID to extend. Provide one of task_id, audio_id, audio_url, or upload_url."},"audio_url":{"type":"string","description":"Source audio URL to extend. Provide one of task_id, audio_id, audio_url, or upload_url."},"upload_url":{"type":"string","description":"Uploaded source audio URL to extend. Provide one of task_id, audio_id, audio_url, or upload_url."},"parameter_mode":{"type":"string","enum":["source","custom"],"description":"Inherit the source track's parameters (source) or supply custom ones (custom)."},"instrumental":{"type":"boolean","description":"When true, generate without vocals."},"prompt":{"type":"string","maxLength":5000,"description":"Extension brief. Cannot be combined with lyrics."},"lyrics":{"type":"string","maxLength":5000,"description":"Exact lyrics. Only allowed when extending uploaded audio in custom parameter mode."},"style":{"type":"string","maxLength":1000,"description":"Style preset. Required in custom parameter mode."},"title":{"type":"string","maxLength":80,"description":"Song title. Required in custom parameter mode."},"continue_at":{"type":"number","description":"Seconds into the source to continue from. Required in custom parameter mode."},"persona_id":{"type":"string","description":"Persona ID."},"persona_type":{"type":"string","enum":["style","voice"],"description":"Persona type."},"negative_tags":{"type":"string","maxLength":200,"description":"Styles to avoid."}},"additionalProperties":false,"required":["model","parameter_mode"]}]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/suno/extend_music/{id}":{"get":{"tags":["Suno"],"summary":"Retrieve Suno Extend-Music task","description":"Create an asynchronous task through the Suno extend music endpoint.","operationId":"task_endpoint_suno_extend_music_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"generation_stage":{"type":"string","enum":["text_generated","first_audio_ready"]},"audios":{"type":"array","items":{"type":"object","required":["id"],"properties":{"id":{"type":"string"},"audio_url":{"type":"string","x-runapi-generated-media":true},"stream_audio_url":{"type":"string","x-runapi-generated-media":true},"image_url":{"type":"string","x-runapi-generated-media":true},"lyrics":{"type":"string"},"model_name":{"type":"string"},"title":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"duration":{"type":"number"}},"unevaluatedProperties":false}}},"unevaluatedProperties":false},{"type":"object","required":["id","status","audios","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"generation_stage":{"type":"string","enum":["text_generated","first_audio_ready","all_audios_ready","failed"]},"audios":{"type":"array","items":{"type":"object","required":["id"],"properties":{"id":{"type":"string"},"audio_url":{"type":"string","x-runapi-generated-media":true},"stream_audio_url":{"type":"string","x-runapi-generated-media":true},"image_url":{"type":"string","x-runapi-generated-media":true},"lyrics":{"type":"string"},"model_name":{"type":"string"},"title":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"duration":{"type":"number"}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/suno/generate_artwork":{"post":{"tags":["Suno"],"summary":"Suno Generate-Artwork","description":"Create an asynchronous task through the Suno generate artwork endpoint.","operationId":"task_endpoint_suno_generate_artwork","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","description":"Completed music generation task ID (text_to_music). Extend or upload tasks are not accepted as artwork sources."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."}},"additionalProperties":false,"required":["task_id"]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/suno/generate_artwork/{id}":{"get":{"tags":["Suno"],"summary":"Retrieve Suno Generate-Artwork task","description":"Create an asynchronous task through the Suno generate artwork endpoint.","operationId":"task_endpoint_suno_generate_artwork_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"covers":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}}},"unevaluatedProperties":false},{"type":"object","required":["id","status","covers","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"covers":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/suno/generate_lyrics":{"post":{"tags":["Suno"],"summary":"Suno Generate-Lyrics","description":"Create an asynchronous task through the Suno generate lyrics endpoint.","operationId":"task_endpoint_suno_generate_lyrics","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string","maxLength":200,"description":"Lyrics generation prompt."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."}},"additionalProperties":false,"required":["prompt"]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/suno/generate_lyrics/{id}":{"get":{"tags":["Suno"],"summary":"Retrieve Suno Generate-Lyrics task","description":"Create an asynchronous task through the Suno generate lyrics endpoint.","operationId":"task_endpoint_suno_generate_lyrics_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"lyrics":{"type":"array","items":{"type":"object","required":["text"],"properties":{"title":{"type":"string"},"text":{"type":"string"}},"unevaluatedProperties":false}}},"unevaluatedProperties":false},{"type":"object","required":["id","status","lyrics","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"lyrics":{"type":"array","items":{"type":"object","required":["text"],"properties":{"title":{"type":"string"},"text":{"type":"string"}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/suno/generate_midi":{"post":{"tags":["Suno"],"summary":"Suno Generate-Midi","description":"Create an asynchronous task through the Suno generate midi endpoint.","operationId":"task_endpoint_suno_generate_midi","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","description":"Source task ID."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."}},"additionalProperties":false,"required":["task_id"]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/suno/generate_midi/{id}":{"get":{"tags":["Suno"],"summary":"Retrieve Suno Generate-Midi task","description":"Create an asynchronous task through the Suno generate midi endpoint.","operationId":"task_endpoint_suno_generate_midi_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"instruments":{"type":"array","items":{"type":"object","required":["name","notes"],"properties":{"name":{"type":"string"},"notes":{"type":"array","items":{"type":"object","required":["pitch","start_time","end_time","velocity"],"properties":{"pitch":{"type":"number"},"start_time":{"type":"number"},"end_time":{"type":"number"},"velocity":{"type":"number"}},"unevaluatedProperties":false}}},"unevaluatedProperties":false}}},"unevaluatedProperties":false},{"type":"object","required":["id","status","instruments","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"instruments":{"type":"array","items":{"type":"object","required":["name","notes"],"properties":{"name":{"type":"string"},"notes":{"type":"array","items":{"type":"object","required":["pitch","start_time","end_time","velocity"],"properties":{"pitch":{"type":"number"},"start_time":{"type":"number"},"end_time":{"type":"number"},"velocity":{"type":"number"}},"unevaluatedProperties":false}}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/suno/inspire_music":{"post":{"tags":["Suno"],"summary":"Suno Inspire-Music","description":"Create an asynchronous task through the Suno inspire music endpoint.","operationId":"task_endpoint_suno_inspire_music","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"suno-v4"},"audio_urls":{"type":"array","items":{"type":"string"},"maxItems":4,"minItems":1,"description":"One to four audio URLs that guide the new music."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."}},"additionalProperties":false,"required":["model","audio_urls"]},{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"suno-v4.5"},"audio_urls":{"type":"array","items":{"type":"string"},"maxItems":4,"minItems":1,"description":"One to four audio URLs that guide the new music."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."}},"additionalProperties":false,"required":["model","audio_urls"]},{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"suno-v4.5-plus"},"audio_urls":{"type":"array","items":{"type":"string"},"maxItems":4,"minItems":1,"description":"One to four audio URLs that guide the new music."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."}},"additionalProperties":false,"required":["model","audio_urls"]},{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"suno-v5"},"audio_urls":{"type":"array","items":{"type":"string"},"maxItems":4,"minItems":1,"description":"One to four audio URLs that guide the new music."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."}},"additionalProperties":false,"required":["model","audio_urls"]},{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"suno-v5.5"},"audio_urls":{"type":"array","items":{"type":"string"},"maxItems":4,"minItems":1,"description":"One to four audio URLs that guide the new music."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."}},"additionalProperties":false,"required":["model","audio_urls"]}]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/suno/inspire_music/{id}":{"get":{"tags":["Suno"],"summary":"Retrieve Suno Inspire-Music task","description":"Create an asynchronous task through the Suno inspire music endpoint.","operationId":"task_endpoint_suno_inspire_music_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"generation_stage":{"type":"string","enum":["text_generated","first_audio_ready"]},"audios":{"type":"array","items":{"type":"object","required":["id"],"properties":{"id":{"type":"string"},"audio_url":{"type":"string","x-runapi-generated-media":true},"stream_audio_url":{"type":"string","x-runapi-generated-media":true},"image_url":{"type":"string","x-runapi-generated-media":true},"lyrics":{"type":"string"},"model_name":{"type":"string"},"title":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"duration":{"type":"number"}},"unevaluatedProperties":false}}},"unevaluatedProperties":false},{"type":"object","required":["id","status","audios","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"generation_stage":{"type":"string","enum":["text_generated","first_audio_ready","all_audios_ready","failed"]},"audios":{"type":"array","items":{"type":"object","required":["id"],"properties":{"id":{"type":"string"},"audio_url":{"type":"string","x-runapi-generated-media":true},"stream_audio_url":{"type":"string","x-runapi-generated-media":true},"image_url":{"type":"string","x-runapi-generated-media":true},"lyrics":{"type":"string"},"model_name":{"type":"string"},"title":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"duration":{"type":"number"}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/suno/regenerate_validation_phrase":{"post":{"tags":["Suno"],"summary":"Suno Regenerate-Validation-Phrase","description":"Create an asynchronous task through the Suno regenerate validation phrase endpoint.","operationId":"task_endpoint_suno_regenerate_validation_phrase","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","description":"Prior validation phrase task ID."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."}},"additionalProperties":false,"required":["task_id"]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/suno/regenerate_validation_phrase/{id}":{"get":{"tags":["Suno"],"summary":"Retrieve Suno Regenerate-Validation-Phrase task","description":"Create an asynchronous task through the Suno regenerate validation phrase endpoint.","operationId":"task_endpoint_suno_regenerate_validation_phrase_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status","provider_status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"provider_status":{"type":"string","enum":["wait_processing","processing_validate"]},"validation_phrase":{"type":"string"}},"unevaluatedProperties":false},{"type":"object","required":["id","status","provider_status","validation_phrase","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"provider_status":{"type":"string"},"validation_phrase":{"type":"string"},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/suno/remaster_audio":{"post":{"tags":["Suno"],"summary":"Suno Remaster-Audio","description":"Create an asynchronous task through the Suno remaster audio endpoint.","operationId":"task_endpoint_suno_remaster_audio","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"model":{"type":"string","description":"Target render model for the remaster; may differ from the source task's model.","const":"suno-v4"},"source_task_id":{"type":"string","description":"Completed Suno music task ID; any model version and any channel is accepted as the source."},"audio_id":{"type":"string","description":"Audio ID within the source task."},"variation_category":{"type":"string","enum":["subtle","normal","high"],"description":"How far the remaster may drift from the original. Applies to suno-v5 and suno-v5.5 targets; defaults to normal."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."}},"additionalProperties":false,"required":["model","source_task_id","audio_id"]},{"type":"object","properties":{"model":{"type":"string","description":"Target render model for the remaster; may differ from the source task's model.","const":"suno-v4.5"},"source_task_id":{"type":"string","description":"Completed Suno music task ID; any model version and any channel is accepted as the source."},"audio_id":{"type":"string","description":"Audio ID within the source task."},"variation_category":{"type":"string","enum":["subtle","normal","high"],"description":"How far the remaster may drift from the original. Applies to suno-v5 and suno-v5.5 targets; defaults to normal."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."}},"additionalProperties":false,"required":["model","source_task_id","audio_id"]},{"type":"object","properties":{"model":{"type":"string","description":"Target render model for the remaster; may differ from the source task's model.","const":"suno-v4.5-plus"},"source_task_id":{"type":"string","description":"Completed Suno music task ID; any model version and any channel is accepted as the source."},"audio_id":{"type":"string","description":"Audio ID within the source task."},"variation_category":{"type":"string","enum":["subtle","normal","high"],"description":"How far the remaster may drift from the original. Applies to suno-v5 and suno-v5.5 targets; defaults to normal."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."}},"additionalProperties":false,"required":["model","source_task_id","audio_id"]},{"type":"object","properties":{"model":{"type":"string","description":"Target render model for the remaster; may differ from the source task's model.","const":"suno-v5"},"source_task_id":{"type":"string","description":"Completed Suno music task ID; any model version and any channel is accepted as the source."},"audio_id":{"type":"string","description":"Audio ID within the source task."},"variation_category":{"type":"string","enum":["subtle","normal","high"],"description":"How far the remaster may drift from the original. Applies to suno-v5 and suno-v5.5 targets; defaults to normal."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."}},"additionalProperties":false,"required":["model","source_task_id","audio_id"]},{"type":"object","properties":{"model":{"type":"string","description":"Target render model for the remaster; may differ from the source task's model.","const":"suno-v5.5"},"source_task_id":{"type":"string","description":"Completed Suno music task ID; any model version and any channel is accepted as the source."},"audio_id":{"type":"string","description":"Audio ID within the source task."},"variation_category":{"type":"string","enum":["subtle","normal","high"],"description":"How far the remaster may drift from the original. Applies to suno-v5 and suno-v5.5 targets; defaults to normal."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."}},"additionalProperties":false,"required":["model","source_task_id","audio_id"]}]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/suno/remaster_audio/{id}":{"get":{"tags":["Suno"],"summary":"Retrieve Suno Remaster-Audio task","description":"Create an asynchronous task through the Suno remaster audio endpoint.","operationId":"task_endpoint_suno_remaster_audio_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"generation_stage":{"type":"string","enum":["text_generated","first_audio_ready"]},"audios":{"type":"array","items":{"type":"object","required":["id"],"properties":{"id":{"type":"string"},"audio_url":{"type":"string","x-runapi-generated-media":true},"stream_audio_url":{"type":"string","x-runapi-generated-media":true},"image_url":{"type":"string","x-runapi-generated-media":true},"lyrics":{"type":"string"},"model_name":{"type":"string"},"title":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"duration":{"type":"number"}},"unevaluatedProperties":false}}},"unevaluatedProperties":false},{"type":"object","required":["id","status","audios","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"generation_stage":{"type":"string","enum":["text_generated","first_audio_ready","all_audios_ready","failed"]},"audios":{"type":"array","items":{"type":"object","required":["id"],"properties":{"id":{"type":"string"},"audio_url":{"type":"string","x-runapi-generated-media":true},"stream_audio_url":{"type":"string","x-runapi-generated-media":true},"image_url":{"type":"string","x-runapi-generated-media":true},"lyrics":{"type":"string"},"model_name":{"type":"string"},"title":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"duration":{"type":"number"}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/suno/replace_section":{"post":{"tags":["Suno"],"summary":"Suno Replace-Section","description":"Create an asynchronous task through the Suno replace section endpoint.","operationId":"task_endpoint_suno_replace_section","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","description":"Source task ID. Use with audio_id; do not combine with upload_url/model."},"audio_id":{"type":"string","description":"Audio ID within the source task. Use with task_id; do not combine with upload_url/model."},"upload_url":{"type":"string","description":"Uploaded source audio URL. Use with model; do not combine with task_id/audio_id."},"model":{"type":"string","enum":["suno-v6","suno-v6-wild","suno-v6-mini","suno-v4","suno-v4.5","suno-v4.5-all","suno-v4.5-plus","suno-v5","suno-v5.5"],"description":"Model slug for uploaded source audio."},"lyrics":{"type":"string","maxLength":5000,"description":"Replacement section lyrics."},"tags":{"type":"string","maxLength":1000,"description":"Style or genre tags."},"title":{"type":"string","maxLength":80,"description":"Song title."},"infill_start_time":{"type":"number","description":"Section start time in seconds; the replacement duration must be at least 10 seconds."},"infill_end_time":{"type":"number","description":"Section end time in seconds; must be greater than infill_start_time and produce a replacement duration of at least 10 seconds."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."},"negative_tags":{"type":"string","maxLength":200,"description":"Styles to avoid."},"full_lyrics":{"type":"string","maxLength":5000,"description":"Complete song lyrics for context."}},"additionalProperties":false,"required":["lyrics","tags","title","infill_start_time","infill_end_time","full_lyrics"]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/suno/replace_section/{id}":{"get":{"tags":["Suno"],"summary":"Retrieve Suno Replace-Section task","description":"Create an asynchronous task through the Suno replace section endpoint.","operationId":"task_endpoint_suno_replace_section_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"track":{"type":"object","properties":{"id":{"type":"string"},"audio_url":{"type":"string","x-runapi-generated-media":true},"stream_audio_url":{"type":"string","x-runapi-generated-media":true},"image_url":{"type":"string","x-runapi-generated-media":true},"lyrics":{"type":"string"},"model_name":{"type":"string"},"title":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"duration":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","track","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"track":{"type":"object","properties":{"id":{"type":"string"},"audio_url":{"type":"string","x-runapi-generated-media":true},"stream_audio_url":{"type":"string","x-runapi-generated-media":true},"image_url":{"type":"string","x-runapi-generated-media":true},"lyrics":{"type":"string"},"model_name":{"type":"string"},"title":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"duration":{"type":"number"}},"unevaluatedProperties":false},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/suno/separate_audio_stems":{"post":{"tags":["Suno"],"summary":"Suno Separate-Audio-Stems","description":"Create an asynchronous task through the Suno separate audio stems endpoint.","operationId":"task_endpoint_suno_separate_audio_stems","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","description":"Source task ID."},"audio_id":{"type":"string","description":"Audio ID within the source task."},"type":{"type":"string","enum":["separate_vocal","split_stem","split_stem_advanced"],"default":"separate_vocal","description":"Stem separation mode."},"stem_name":{"type":"string","enum":["Lead Vocal","Drum Kit","Kick","Snare","Risers","Bass","Backing Vocals","Piano","Electric Guitar","Percussion","String Section","Synth","Acoustic Guitar","Sound Effects","Synth Pad","Synth Bass","Guitar","Brass Section","Organ","Electronic Drum Kit","Lead Electric Guitar","Synth Keys","Rhythm Electric Guitar","Electric Piano","Upright Bass","Keyboards","Distorted Electric Guitar","Synth Strings","Synth Lead","Woodwinds","Rhythm Acoustic Guitar","Flute","Harp","Tambourine","Trumpet","Arpeggiator","Accordion","Fiddle","Pedal Steel Guitar","Synth Voice","Violin","Digital Piano","Synth Brass","Mandolin","Choir","Banjo","Bells","Clarinet","Tenor Saxophone","Trombone","Shaker","French Horn","Glockenspiel","Electric Bass","Cello","Timpani","Harmonica","Marimba","Vibraphone","Lap Steel Guitar","Saxophone","Orchestra","Horns","Cymbals","Hand Clap","Oboe","Celesta","Congas","Drone","Alto Saxophone","Double Bass","Ukulele","Harpsichord","Baritone Saxophone","Xylophone","Tuba","Bass Guitar","Whistle","Lead Guitar","Rhodes","808","Bongos","Bassoon","Cowbell","Viola","Sitar","Steel Drums","Piccolo","Theremin","Bagpipes","Hi-Hat","Music Box","Melodica","Tabla","Koto","Djembe","Taiko","Didgeridoo"],"description":"Target stem for advanced separation. Required when type is split_stem_advanced."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."}},"additionalProperties":false,"required":["task_id","audio_id"],"allOf":[{"if":{"properties":{"type":{"const":"split_stem_advanced"}},"required":["type"]},"then":{"required":["stem_name"]}}]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/suno/separate_audio_stems/{id}":{"get":{"tags":["Suno"],"summary":"Retrieve Suno Separate-Audio-Stems task","description":"Create an asynchronous task through the Suno separate audio stems endpoint.","operationId":"task_endpoint_suno_separate_audio_stems_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"separated_audios":{"type":"object","properties":{"vocal_url":{"type":"string","x-runapi-generated-media":true},"instrumental_url":{"type":"string","x-runapi-generated-media":true},"backing_vocals_url":{"type":"string","x-runapi-generated-media":true},"bass_url":{"type":"string","x-runapi-generated-media":true},"brass_url":{"type":"string","x-runapi-generated-media":true},"drums_url":{"type":"string","x-runapi-generated-media":true},"fx_url":{"type":"string","x-runapi-generated-media":true},"guitar_url":{"type":"string","x-runapi-generated-media":true},"keyboard_url":{"type":"string","x-runapi-generated-media":true},"percussion_url":{"type":"string","x-runapi-generated-media":true},"piano_url":{"type":"string","x-runapi-generated-media":true},"strings_url":{"type":"string","x-runapi-generated-media":true},"synth_url":{"type":"string","x-runapi-generated-media":true},"woodwinds_url":{"type":"string","x-runapi-generated-media":true},"pairs":{"type":"array","items":{"type":"object","required":["stem_name","extracted_audio","remaining_audio"],"properties":{"stem_name":{"type":"string"},"extracted_audio":{"type":"object","properties":{"id":{"type":"string"},"duration_seconds":{"type":"number"},"audio_url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false},"remaining_audio":{"type":"object","properties":{"id":{"type":"string"},"duration_seconds":{"type":"number"},"audio_url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"unevaluatedProperties":false}}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","separated_audios","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"separated_audios":{"type":"object","properties":{"vocal_url":{"type":"string","x-runapi-generated-media":true},"instrumental_url":{"type":"string","x-runapi-generated-media":true},"backing_vocals_url":{"type":"string","x-runapi-generated-media":true},"bass_url":{"type":"string","x-runapi-generated-media":true},"brass_url":{"type":"string","x-runapi-generated-media":true},"drums_url":{"type":"string","x-runapi-generated-media":true},"fx_url":{"type":"string","x-runapi-generated-media":true},"guitar_url":{"type":"string","x-runapi-generated-media":true},"keyboard_url":{"type":"string","x-runapi-generated-media":true},"percussion_url":{"type":"string","x-runapi-generated-media":true},"piano_url":{"type":"string","x-runapi-generated-media":true},"strings_url":{"type":"string","x-runapi-generated-media":true},"synth_url":{"type":"string","x-runapi-generated-media":true},"woodwinds_url":{"type":"string","x-runapi-generated-media":true},"pairs":{"type":"array","items":{"type":"object","required":["stem_name","extracted_audio","remaining_audio"],"properties":{"stem_name":{"type":"string"},"extracted_audio":{"type":"object","properties":{"id":{"type":"string"},"duration_seconds":{"type":"number"},"audio_url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false},"remaining_audio":{"type":"object","properties":{"id":{"type":"string"},"duration_seconds":{"type":"number"},"audio_url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"unevaluatedProperties":false}}},"unevaluatedProperties":false},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/suno/stitch_audio":{"post":{"tags":["Suno"],"summary":"Suno Stitch-Audio","description":"Create an asynchronous task through the Suno stitch audio endpoint.","operationId":"task_endpoint_suno_stitch_audio","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"suno-v4"},"source_task_id":{"type":"string","description":"Completed source task ID."},"audio_id":{"type":"string","description":"Audio ID within the source task."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."}},"additionalProperties":false,"required":["model","source_task_id","audio_id"]},{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"suno-v4.5"},"source_task_id":{"type":"string","description":"Completed source task ID."},"audio_id":{"type":"string","description":"Audio ID within the source task."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."}},"additionalProperties":false,"required":["model","source_task_id","audio_id"]},{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"suno-v4.5-plus"},"source_task_id":{"type":"string","description":"Completed source task ID."},"audio_id":{"type":"string","description":"Audio ID within the source task."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."}},"additionalProperties":false,"required":["model","source_task_id","audio_id"]},{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"suno-v5"},"source_task_id":{"type":"string","description":"Completed source task ID."},"audio_id":{"type":"string","description":"Audio ID within the source task."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."}},"additionalProperties":false,"required":["model","source_task_id","audio_id"]},{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"suno-v5.5"},"source_task_id":{"type":"string","description":"Completed source task ID."},"audio_id":{"type":"string","description":"Audio ID within the source task."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."}},"additionalProperties":false,"required":["model","source_task_id","audio_id"]}]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/suno/stitch_audio/{id}":{"get":{"tags":["Suno"],"summary":"Retrieve Suno Stitch-Audio task","description":"Create an asynchronous task through the Suno stitch audio endpoint.","operationId":"task_endpoint_suno_stitch_audio_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"generation_stage":{"type":"string","enum":["text_generated","first_audio_ready"]},"audios":{"type":"array","items":{"type":"object","required":["id"],"properties":{"id":{"type":"string"},"audio_url":{"type":"string","x-runapi-generated-media":true},"stream_audio_url":{"type":"string","x-runapi-generated-media":true},"image_url":{"type":"string","x-runapi-generated-media":true},"lyrics":{"type":"string"},"model_name":{"type":"string"},"title":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"duration":{"type":"number"}},"unevaluatedProperties":false}}},"unevaluatedProperties":false},{"type":"object","required":["id","status","audios","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"generation_stage":{"type":"string","enum":["text_generated","first_audio_ready","all_audios_ready","failed"]},"audios":{"type":"array","items":{"type":"object","required":["id"],"properties":{"id":{"type":"string"},"audio_url":{"type":"string","x-runapi-generated-media":true},"stream_audio_url":{"type":"string","x-runapi-generated-media":true},"image_url":{"type":"string","x-runapi-generated-media":true},"lyrics":{"type":"string"},"model_name":{"type":"string"},"title":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"duration":{"type":"number"}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/suno/text_to_music":{"post":{"tags":["Suno"],"summary":"Suno Text-to-Music","description":"Create an asynchronous task through the Suno text to music endpoint.","operationId":"task_endpoint_suno_text_to_music","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"callback_url":{"type":"string","description":"Webhook URL for async notifications."},"model":{"type":"string","description":"Model slug.","const":"suno-v4"},"vocal_gender":{"type":"string","enum":["male","female"],"description":"Vocal gender."},"style_weight":{"type":"number","maximum":1,"minimum":0,"description":"Style adherence weight (0-1)."},"weirdness_constraint":{"type":"number","maximum":1,"minimum":0,"description":"Weirdness constraint (0-1)."},"audio_weight":{"type":"number","maximum":1,"minimum":0,"description":"Audio weight (0-1)."},"vocal_mode":{"type":"string","enum":["auto_lyrics","exact_lyrics","instrumental"],"description":"Vocal generation mode."},"prompt":{"type":"string","maxLength":5000,"description":"Song brief for automatic lyrics."},"lyrics":{"type":"string","maxLength":5000,"description":"Exact lyrics to sing."},"style":{"type":"string","maxLength":1000,"description":"Music style."},"title":{"type":"string","maxLength":80,"description":"Music title."},"negative_tags":{"type":"string","maxLength":200,"description":"Styles to avoid."},"persona_id":{"type":"string","description":"Persona ID."},"persona_type":{"type":"string","enum":["style","voice"],"description":"Persona type."},"voice_id":{"type":"string","description":"RunAPI Voice handle."},"continue_at":{"type":"number","description":"Timestamp in seconds to continue from."}},"additionalProperties":false,"required":["model","vocal_mode"],"allOf":[{"if":{"properties":{"vocal_mode":{"const":"auto_lyrics"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["prompt"]},{"not":{"required":["lyrics"]}},{"not":{"required":["style"]}},{"not":{"required":["title"]}},{"not":{"required":["negative_tags"]}},{"not":{"required":["vocal_gender"]}},{"not":{"required":["duration_seconds"]}}]}},{"if":{"properties":{"vocal_mode":{"const":"exact_lyrics"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["lyrics","style","title"]},{"not":{"required":["prompt"]}}]}},{"if":{"properties":{"vocal_mode":{"const":"instrumental"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["style","title"]},{"not":{"required":["prompt"]}},{"not":{"required":["lyrics"]}},{"not":{"required":["vocal_gender"]}}]}},{"if":{"properties":{"model":{"const":"suno-v4"}},"required":["model"]},"then":{"not":{"required":["duration_seconds"]}}},{"if":{"properties":{"model":{"const":"suno-v4.5"}},"required":["model"]},"then":{"not":{"required":["duration_seconds"]}}},{"if":{"properties":{"model":{"const":"suno-v4.5-all"}},"required":["model"]},"then":{"not":{"required":["duration_seconds"]}}},{"if":{"properties":{"model":{"const":"suno-v4.5-plus"}},"required":["model"]},"then":{"not":{"required":["duration_seconds"]}}},{"if":{"properties":{"model":{"const":"suno-v5"}},"required":["model"]},"then":{"not":{"required":["duration_seconds"]}}},{"if":{"required":["voice_id"]},"then":{"allOf":[{"not":{"required":["persona_id"]}},{"not":{"required":["persona_type"]}}]}}]},{"type":"object","properties":{"callback_url":{"type":"string","description":"Webhook URL for async notifications."},"model":{"type":"string","description":"Model slug.","const":"suno-v4.5"},"vocal_gender":{"type":"string","enum":["male","female"],"description":"Vocal gender."},"style_weight":{"type":"number","maximum":1,"minimum":0,"description":"Style adherence weight (0-1)."},"weirdness_constraint":{"type":"number","maximum":1,"minimum":0,"description":"Weirdness constraint (0-1)."},"audio_weight":{"type":"number","maximum":1,"minimum":0,"description":"Audio weight (0-1)."},"vocal_mode":{"type":"string","enum":["auto_lyrics","exact_lyrics","instrumental"],"description":"Vocal generation mode."},"prompt":{"type":"string","maxLength":5000,"description":"Song brief for automatic lyrics."},"lyrics":{"type":"string","maxLength":5000,"description":"Exact lyrics to sing."},"style":{"type":"string","maxLength":1000,"description":"Music style."},"title":{"type":"string","maxLength":80,"description":"Music title."},"negative_tags":{"type":"string","maxLength":200,"description":"Styles to avoid."},"persona_id":{"type":"string","description":"Persona ID."},"persona_type":{"type":"string","enum":["style","voice"],"description":"Persona type."},"voice_id":{"type":"string","description":"RunAPI Voice handle."},"continue_at":{"type":"number","description":"Timestamp in seconds to continue from."}},"additionalProperties":false,"required":["model","vocal_mode"],"allOf":[{"if":{"properties":{"vocal_mode":{"const":"auto_lyrics"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["prompt"]},{"not":{"required":["lyrics"]}},{"not":{"required":["style"]}},{"not":{"required":["title"]}},{"not":{"required":["negative_tags"]}},{"not":{"required":["vocal_gender"]}},{"not":{"required":["duration_seconds"]}}]}},{"if":{"properties":{"vocal_mode":{"const":"exact_lyrics"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["lyrics","style","title"]},{"not":{"required":["prompt"]}}]}},{"if":{"properties":{"vocal_mode":{"const":"instrumental"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["style","title"]},{"not":{"required":["prompt"]}},{"not":{"required":["lyrics"]}},{"not":{"required":["vocal_gender"]}}]}},{"if":{"properties":{"model":{"const":"suno-v4"}},"required":["model"]},"then":{"not":{"required":["duration_seconds"]}}},{"if":{"properties":{"model":{"const":"suno-v4.5"}},"required":["model"]},"then":{"not":{"required":["duration_seconds"]}}},{"if":{"properties":{"model":{"const":"suno-v4.5-all"}},"required":["model"]},"then":{"not":{"required":["duration_seconds"]}}},{"if":{"properties":{"model":{"const":"suno-v4.5-plus"}},"required":["model"]},"then":{"not":{"required":["duration_seconds"]}}},{"if":{"properties":{"model":{"const":"suno-v5"}},"required":["model"]},"then":{"not":{"required":["duration_seconds"]}}},{"if":{"required":["voice_id"]},"then":{"allOf":[{"not":{"required":["persona_id"]}},{"not":{"required":["persona_type"]}}]}}]},{"type":"object","properties":{"callback_url":{"type":"string","description":"Webhook URL for async notifications."},"model":{"type":"string","description":"Model slug.","const":"suno-v4.5-all"},"vocal_gender":{"type":"string","enum":["male","female"],"description":"Vocal gender."},"style_weight":{"type":"number","maximum":1,"minimum":0,"description":"Style adherence weight (0-1)."},"weirdness_constraint":{"type":"number","maximum":1,"minimum":0,"description":"Weirdness constraint (0-1)."},"audio_weight":{"type":"number","maximum":1,"minimum":0,"description":"Audio weight (0-1)."},"vocal_mode":{"type":"string","enum":["auto_lyrics","exact_lyrics","instrumental"],"description":"Vocal generation mode."},"prompt":{"type":"string","maxLength":5000,"description":"Song brief for automatic lyrics."},"lyrics":{"type":"string","maxLength":5000,"description":"Exact lyrics to sing."},"style":{"type":"string","maxLength":1000,"description":"Music style."},"title":{"type":"string","maxLength":80,"description":"Music title."},"negative_tags":{"type":"string","maxLength":200,"description":"Styles to avoid."},"persona_id":{"type":"string","description":"Persona ID."},"persona_type":{"type":"string","enum":["style","voice"],"description":"Persona type."},"voice_id":{"type":"string","description":"RunAPI Voice handle."},"continue_at":{"type":"number","description":"Timestamp in seconds to continue from."}},"additionalProperties":false,"required":["model","vocal_mode"],"allOf":[{"if":{"properties":{"vocal_mode":{"const":"auto_lyrics"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["prompt"]},{"not":{"required":["lyrics"]}},{"not":{"required":["style"]}},{"not":{"required":["title"]}},{"not":{"required":["negative_tags"]}},{"not":{"required":["vocal_gender"]}},{"not":{"required":["duration_seconds"]}}]}},{"if":{"properties":{"vocal_mode":{"const":"exact_lyrics"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["lyrics","style","title"]},{"not":{"required":["prompt"]}}]}},{"if":{"properties":{"vocal_mode":{"const":"instrumental"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["style","title"]},{"not":{"required":["prompt"]}},{"not":{"required":["lyrics"]}},{"not":{"required":["vocal_gender"]}}]}},{"if":{"properties":{"model":{"const":"suno-v4"}},"required":["model"]},"then":{"not":{"required":["duration_seconds"]}}},{"if":{"properties":{"model":{"const":"suno-v4.5"}},"required":["model"]},"then":{"not":{"required":["duration_seconds"]}}},{"if":{"properties":{"model":{"const":"suno-v4.5-all"}},"required":["model"]},"then":{"not":{"required":["duration_seconds"]}}},{"if":{"properties":{"model":{"const":"suno-v4.5-plus"}},"required":["model"]},"then":{"not":{"required":["duration_seconds"]}}},{"if":{"properties":{"model":{"const":"suno-v5"}},"required":["model"]},"then":{"not":{"required":["duration_seconds"]}}},{"if":{"required":["voice_id"]},"then":{"allOf":[{"not":{"required":["persona_id"]}},{"not":{"required":["persona_type"]}}]}}]},{"type":"object","properties":{"callback_url":{"type":"string","description":"Webhook URL for async notifications."},"model":{"type":"string","description":"Model slug.","const":"suno-v4.5-plus"},"vocal_gender":{"type":"string","enum":["male","female"],"description":"Vocal gender."},"style_weight":{"type":"number","maximum":1,"minimum":0,"description":"Style adherence weight (0-1)."},"weirdness_constraint":{"type":"number","maximum":1,"minimum":0,"description":"Weirdness constraint (0-1)."},"audio_weight":{"type":"number","maximum":1,"minimum":0,"description":"Audio weight (0-1)."},"vocal_mode":{"type":"string","enum":["auto_lyrics","exact_lyrics","instrumental"],"description":"Vocal generation mode."},"prompt":{"type":"string","maxLength":5000,"description":"Song brief for automatic lyrics."},"lyrics":{"type":"string","maxLength":5000,"description":"Exact lyrics to sing."},"style":{"type":"string","maxLength":1000,"description":"Music style."},"title":{"type":"string","maxLength":80,"description":"Music title."},"negative_tags":{"type":"string","maxLength":200,"description":"Styles to avoid."},"persona_id":{"type":"string","description":"Persona ID."},"persona_type":{"type":"string","enum":["style","voice"],"description":"Persona type."},"voice_id":{"type":"string","description":"RunAPI Voice handle."},"continue_at":{"type":"number","description":"Timestamp in seconds to continue from."}},"additionalProperties":false,"required":["model","vocal_mode"],"allOf":[{"if":{"properties":{"vocal_mode":{"const":"auto_lyrics"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["prompt"]},{"not":{"required":["lyrics"]}},{"not":{"required":["style"]}},{"not":{"required":["title"]}},{"not":{"required":["negative_tags"]}},{"not":{"required":["vocal_gender"]}},{"not":{"required":["duration_seconds"]}}]}},{"if":{"properties":{"vocal_mode":{"const":"exact_lyrics"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["lyrics","style","title"]},{"not":{"required":["prompt"]}}]}},{"if":{"properties":{"vocal_mode":{"const":"instrumental"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["style","title"]},{"not":{"required":["prompt"]}},{"not":{"required":["lyrics"]}},{"not":{"required":["vocal_gender"]}}]}},{"if":{"properties":{"model":{"const":"suno-v4"}},"required":["model"]},"then":{"not":{"required":["duration_seconds"]}}},{"if":{"properties":{"model":{"const":"suno-v4.5"}},"required":["model"]},"then":{"not":{"required":["duration_seconds"]}}},{"if":{"properties":{"model":{"const":"suno-v4.5-all"}},"required":["model"]},"then":{"not":{"required":["duration_seconds"]}}},{"if":{"properties":{"model":{"const":"suno-v4.5-plus"}},"required":["model"]},"then":{"not":{"required":["duration_seconds"]}}},{"if":{"properties":{"model":{"const":"suno-v5"}},"required":["model"]},"then":{"not":{"required":["duration_seconds"]}}},{"if":{"required":["voice_id"]},"then":{"allOf":[{"not":{"required":["persona_id"]}},{"not":{"required":["persona_type"]}}]}}]},{"type":"object","properties":{"callback_url":{"type":"string","description":"Webhook URL for async notifications."},"model":{"type":"string","description":"Model slug.","const":"suno-v5"},"vocal_gender":{"type":"string","enum":["male","female"],"description":"Vocal gender."},"style_weight":{"type":"number","maximum":1,"minimum":0,"description":"Style adherence weight (0-1)."},"weirdness_constraint":{"type":"number","maximum":1,"minimum":0,"description":"Weirdness constraint (0-1)."},"audio_weight":{"type":"number","maximum":1,"minimum":0,"description":"Audio weight (0-1)."},"vocal_mode":{"type":"string","enum":["auto_lyrics","exact_lyrics","instrumental"],"description":"Vocal generation mode."},"prompt":{"type":"string","maxLength":5000,"description":"Song brief for automatic lyrics."},"lyrics":{"type":"string","maxLength":5000,"description":"Exact lyrics to sing."},"style":{"type":"string","maxLength":1000,"description":"Music style."},"title":{"type":"string","maxLength":80,"description":"Music title."},"negative_tags":{"type":"string","maxLength":200,"description":"Styles to avoid."},"persona_id":{"type":"string","description":"Persona ID."},"persona_type":{"type":"string","enum":["style","voice"],"description":"Persona type."},"voice_id":{"type":"string","description":"RunAPI Voice handle."},"continue_at":{"type":"number","description":"Timestamp in seconds to continue from."}},"additionalProperties":false,"required":["model","vocal_mode"],"allOf":[{"if":{"properties":{"vocal_mode":{"const":"auto_lyrics"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["prompt"]},{"not":{"required":["lyrics"]}},{"not":{"required":["style"]}},{"not":{"required":["title"]}},{"not":{"required":["negative_tags"]}},{"not":{"required":["vocal_gender"]}},{"not":{"required":["duration_seconds"]}}]}},{"if":{"properties":{"vocal_mode":{"const":"exact_lyrics"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["lyrics","style","title"]},{"not":{"required":["prompt"]}}]}},{"if":{"properties":{"vocal_mode":{"const":"instrumental"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["style","title"]},{"not":{"required":["prompt"]}},{"not":{"required":["lyrics"]}},{"not":{"required":["vocal_gender"]}}]}},{"if":{"properties":{"model":{"const":"suno-v4"}},"required":["model"]},"then":{"not":{"required":["duration_seconds"]}}},{"if":{"properties":{"model":{"const":"suno-v4.5"}},"required":["model"]},"then":{"not":{"required":["duration_seconds"]}}},{"if":{"properties":{"model":{"const":"suno-v4.5-all"}},"required":["model"]},"then":{"not":{"required":["duration_seconds"]}}},{"if":{"properties":{"model":{"const":"suno-v4.5-plus"}},"required":["model"]},"then":{"not":{"required":["duration_seconds"]}}},{"if":{"properties":{"model":{"const":"suno-v5"}},"required":["model"]},"then":{"not":{"required":["duration_seconds"]}}},{"if":{"required":["voice_id"]},"then":{"allOf":[{"not":{"required":["persona_id"]}},{"not":{"required":["persona_type"]}}]}}]},{"type":"object","properties":{"callback_url":{"type":"string","description":"Webhook URL for async notifications."},"model":{"type":"string","description":"Model slug.","const":"suno-v5.5"},"vocal_gender":{"type":"string","enum":["male","female"],"description":"Vocal gender."},"style_weight":{"type":"number","maximum":1,"minimum":0,"description":"Style adherence weight (0-1)."},"weirdness_constraint":{"type":"number","maximum":1,"minimum":0,"description":"Weirdness constraint (0-1)."},"audio_weight":{"type":"number","maximum":1,"minimum":0,"description":"Audio weight (0-1)."},"vocal_mode":{"type":"string","enum":["auto_lyrics","exact_lyrics","instrumental"],"description":"Vocal generation mode."},"prompt":{"type":"string","maxLength":5000,"description":"Song brief for automatic lyrics."},"lyrics":{"type":"string","maxLength":5000,"description":"Exact lyrics to sing."},"style":{"type":"string","maxLength":1000,"description":"Music style."},"title":{"type":"string","maxLength":80,"description":"Music title."},"negative_tags":{"type":"string","maxLength":200,"description":"Styles to avoid."},"persona_id":{"type":"string","description":"Persona ID."},"persona_type":{"type":"string","enum":["style","voice"],"description":"Persona type."},"voice_id":{"type":"string","description":"RunAPI Voice handle."},"duration_seconds":{"type":"integer","maximum":360,"minimum":10,"description":"Preferred duration in seconds; only available for Suno V5.5 custom requests."},"continue_at":{"type":"number","description":"Timestamp in seconds to continue from."}},"additionalProperties":false,"required":["model","vocal_mode"],"allOf":[{"if":{"properties":{"vocal_mode":{"const":"auto_lyrics"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["prompt"]},{"not":{"required":["lyrics"]}},{"not":{"required":["style"]}},{"not":{"required":["title"]}},{"not":{"required":["negative_tags"]}},{"not":{"required":["vocal_gender"]}},{"not":{"required":["duration_seconds"]}}]}},{"if":{"properties":{"vocal_mode":{"const":"exact_lyrics"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["lyrics","style","title"]},{"not":{"required":["prompt"]}}]}},{"if":{"properties":{"vocal_mode":{"const":"instrumental"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["style","title"]},{"not":{"required":["prompt"]}},{"not":{"required":["lyrics"]}},{"not":{"required":["vocal_gender"]}}]}},{"if":{"properties":{"model":{"const":"suno-v4"}},"required":["model"]},"then":{"not":{"required":["duration_seconds"]}}},{"if":{"properties":{"model":{"const":"suno-v4.5"}},"required":["model"]},"then":{"not":{"required":["duration_seconds"]}}},{"if":{"properties":{"model":{"const":"suno-v4.5-all"}},"required":["model"]},"then":{"not":{"required":["duration_seconds"]}}},{"if":{"properties":{"model":{"const":"suno-v4.5-plus"}},"required":["model"]},"then":{"not":{"required":["duration_seconds"]}}},{"if":{"properties":{"model":{"const":"suno-v5"}},"required":["model"]},"then":{"not":{"required":["duration_seconds"]}}},{"if":{"required":["voice_id"]},"then":{"allOf":[{"not":{"required":["persona_id"]}},{"not":{"required":["persona_type"]}}]}}]},{"type":"object","properties":{"callback_url":{"type":"string","description":"Webhook URL for async notifications."},"model":{"type":"string","description":"Model slug.","const":"suno-v6"},"vocal_gender":{"type":"string","enum":["male","female"],"description":"Vocal gender."},"style_weight":{"type":"number","maximum":1,"minimum":0,"description":"Style adherence weight (0-1)."},"weirdness_constraint":{"type":"number","maximum":1,"minimum":0,"description":"Weirdness constraint (0-1)."},"audio_weight":{"type":"number","maximum":1,"minimum":0,"description":"Audio weight (0-1)."},"vocal_mode":{"type":"string","enum":["auto_lyrics","exact_lyrics","instrumental"],"description":"Vocal generation mode."},"prompt":{"type":"string","maxLength":5000,"description":"Song brief for automatic lyrics."},"lyrics":{"type":"string","maxLength":5000,"description":"Exact lyrics to sing."},"style":{"type":"string","maxLength":1000,"description":"Music style."},"title":{"type":"string","maxLength":80,"description":"Music title."},"negative_tags":{"type":"string","maxLength":200,"description":"Styles to avoid."},"persona_id":{"type":"string","description":"Persona ID."},"persona_type":{"type":"string","enum":["style","voice"],"description":"Persona type."},"voice_id":{"type":"string","description":"RunAPI Voice handle."},"duration_seconds":{"type":"integer","maximum":360,"minimum":10,"description":"Preferred duration in seconds; only available for Suno V5.5 custom requests."},"continue_at":{"type":"number","description":"Timestamp in seconds to continue from."}},"additionalProperties":false,"required":["model","vocal_mode"],"allOf":[{"if":{"properties":{"vocal_mode":{"const":"auto_lyrics"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["prompt"]},{"not":{"required":["lyrics"]}},{"not":{"required":["style"]}},{"not":{"required":["title"]}},{"not":{"required":["negative_tags"]}},{"not":{"required":["vocal_gender"]}},{"not":{"required":["duration_seconds"]}}]}},{"if":{"properties":{"vocal_mode":{"const":"exact_lyrics"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["lyrics","style","title"]},{"not":{"required":["prompt"]}}]}},{"if":{"properties":{"vocal_mode":{"const":"instrumental"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["style","title"]},{"not":{"required":["prompt"]}},{"not":{"required":["lyrics"]}},{"not":{"required":["vocal_gender"]}}]}},{"if":{"properties":{"model":{"const":"suno-v4"}},"required":["model"]},"then":{"not":{"required":["duration_seconds"]}}},{"if":{"properties":{"model":{"const":"suno-v4.5"}},"required":["model"]},"then":{"not":{"required":["duration_seconds"]}}},{"if":{"properties":{"model":{"const":"suno-v4.5-all"}},"required":["model"]},"then":{"not":{"required":["duration_seconds"]}}},{"if":{"properties":{"model":{"const":"suno-v4.5-plus"}},"required":["model"]},"then":{"not":{"required":["duration_seconds"]}}},{"if":{"properties":{"model":{"const":"suno-v5"}},"required":["model"]},"then":{"not":{"required":["duration_seconds"]}}},{"if":{"required":["voice_id"]},"then":{"allOf":[{"not":{"required":["persona_id"]}},{"not":{"required":["persona_type"]}}]}}]},{"type":"object","properties":{"callback_url":{"type":"string","description":"Webhook URL for async notifications."},"model":{"type":"string","description":"Model slug.","const":"suno-v6-mini"},"vocal_gender":{"type":"string","enum":["male","female"],"description":"Vocal gender."},"style_weight":{"type":"number","maximum":1,"minimum":0,"description":"Style adherence weight (0-1)."},"weirdness_constraint":{"type":"number","maximum":1,"minimum":0,"description":"Weirdness constraint (0-1)."},"audio_weight":{"type":"number","maximum":1,"minimum":0,"description":"Audio weight (0-1)."},"vocal_mode":{"type":"string","enum":["auto_lyrics","exact_lyrics","instrumental"],"description":"Vocal generation mode."},"prompt":{"type":"string","maxLength":5000,"description":"Song brief for automatic lyrics."},"lyrics":{"type":"string","maxLength":5000,"description":"Exact lyrics to sing."},"style":{"type":"string","maxLength":1000,"description":"Music style."},"title":{"type":"string","maxLength":80,"description":"Music title."},"negative_tags":{"type":"string","maxLength":200,"description":"Styles to avoid."},"persona_id":{"type":"string","description":"Persona ID."},"persona_type":{"type":"string","enum":["style","voice"],"description":"Persona type."},"voice_id":{"type":"string","description":"RunAPI Voice handle."},"duration_seconds":{"type":"integer","maximum":360,"minimum":10,"description":"Preferred duration in seconds; only available for Suno V5.5 custom requests."},"continue_at":{"type":"number","description":"Timestamp in seconds to continue from."}},"additionalProperties":false,"required":["model","vocal_mode"],"allOf":[{"if":{"properties":{"vocal_mode":{"const":"auto_lyrics"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["prompt"]},{"not":{"required":["lyrics"]}},{"not":{"required":["style"]}},{"not":{"required":["title"]}},{"not":{"required":["negative_tags"]}},{"not":{"required":["vocal_gender"]}},{"not":{"required":["duration_seconds"]}}]}},{"if":{"properties":{"vocal_mode":{"const":"exact_lyrics"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["lyrics","style","title"]},{"not":{"required":["prompt"]}}]}},{"if":{"properties":{"vocal_mode":{"const":"instrumental"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["style","title"]},{"not":{"required":["prompt"]}},{"not":{"required":["lyrics"]}},{"not":{"required":["vocal_gender"]}}]}},{"if":{"properties":{"model":{"const":"suno-v4"}},"required":["model"]},"then":{"not":{"required":["duration_seconds"]}}},{"if":{"properties":{"model":{"const":"suno-v4.5"}},"required":["model"]},"then":{"not":{"required":["duration_seconds"]}}},{"if":{"properties":{"model":{"const":"suno-v4.5-all"}},"required":["model"]},"then":{"not":{"required":["duration_seconds"]}}},{"if":{"properties":{"model":{"const":"suno-v4.5-plus"}},"required":["model"]},"then":{"not":{"required":["duration_seconds"]}}},{"if":{"properties":{"model":{"const":"suno-v5"}},"required":["model"]},"then":{"not":{"required":["duration_seconds"]}}},{"if":{"required":["voice_id"]},"then":{"allOf":[{"not":{"required":["persona_id"]}},{"not":{"required":["persona_type"]}}]}}]},{"type":"object","properties":{"callback_url":{"type":"string","description":"Webhook URL for async notifications."},"model":{"type":"string","description":"Model slug.","const":"suno-v6-wild"},"vocal_gender":{"type":"string","enum":["male","female"],"description":"Vocal gender."},"style_weight":{"type":"number","maximum":1,"minimum":0,"description":"Style adherence weight (0-1)."},"weirdness_constraint":{"type":"number","maximum":1,"minimum":0,"description":"Weirdness constraint (0-1)."},"audio_weight":{"type":"number","maximum":1,"minimum":0,"description":"Audio weight (0-1)."},"vocal_mode":{"type":"string","enum":["auto_lyrics","exact_lyrics","instrumental"],"description":"Vocal generation mode."},"prompt":{"type":"string","maxLength":5000,"description":"Song brief for automatic lyrics."},"lyrics":{"type":"string","maxLength":5000,"description":"Exact lyrics to sing."},"style":{"type":"string","maxLength":1000,"description":"Music style."},"title":{"type":"string","maxLength":80,"description":"Music title."},"negative_tags":{"type":"string","maxLength":200,"description":"Styles to avoid."},"persona_id":{"type":"string","description":"Persona ID."},"persona_type":{"type":"string","enum":["style","voice"],"description":"Persona type."},"voice_id":{"type":"string","description":"RunAPI Voice handle."},"duration_seconds":{"type":"integer","maximum":360,"minimum":10,"description":"Preferred duration in seconds; only available for Suno V5.5 custom requests."},"continue_at":{"type":"number","description":"Timestamp in seconds to continue from."}},"additionalProperties":false,"required":["model","vocal_mode"],"allOf":[{"if":{"properties":{"vocal_mode":{"const":"auto_lyrics"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["prompt"]},{"not":{"required":["lyrics"]}},{"not":{"required":["style"]}},{"not":{"required":["title"]}},{"not":{"required":["negative_tags"]}},{"not":{"required":["vocal_gender"]}},{"not":{"required":["duration_seconds"]}}]}},{"if":{"properties":{"vocal_mode":{"const":"exact_lyrics"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["lyrics","style","title"]},{"not":{"required":["prompt"]}}]}},{"if":{"properties":{"vocal_mode":{"const":"instrumental"}},"required":["vocal_mode"]},"then":{"allOf":[{"required":["style","title"]},{"not":{"required":["prompt"]}},{"not":{"required":["lyrics"]}},{"not":{"required":["vocal_gender"]}}]}},{"if":{"properties":{"model":{"const":"suno-v4"}},"required":["model"]},"then":{"not":{"required":["duration_seconds"]}}},{"if":{"properties":{"model":{"const":"suno-v4.5"}},"required":["model"]},"then":{"not":{"required":["duration_seconds"]}}},{"if":{"properties":{"model":{"const":"suno-v4.5-all"}},"required":["model"]},"then":{"not":{"required":["duration_seconds"]}}},{"if":{"properties":{"model":{"const":"suno-v4.5-plus"}},"required":["model"]},"then":{"not":{"required":["duration_seconds"]}}},{"if":{"properties":{"model":{"const":"suno-v5"}},"required":["model"]},"then":{"not":{"required":["duration_seconds"]}}},{"if":{"required":["voice_id"]},"then":{"allOf":[{"not":{"required":["persona_id"]}},{"not":{"required":["persona_type"]}}]}}]}]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/suno/text_to_music/{id}":{"get":{"tags":["Suno"],"summary":"Retrieve Suno Text-to-Music task","description":"Create an asynchronous task through the Suno text to music endpoint.","operationId":"task_endpoint_suno_text_to_music_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"generation_stage":{"type":"string","enum":["text_generated","first_audio_ready"]},"audios":{"type":"array","items":{"type":"object","required":["id"],"properties":{"id":{"type":"string"},"audio_url":{"type":"string","x-runapi-generated-media":true},"stream_audio_url":{"type":"string","x-runapi-generated-media":true},"image_url":{"type":"string","x-runapi-generated-media":true},"lyrics":{"type":"string"},"model_name":{"type":"string"},"title":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"duration":{"type":"number"}},"unevaluatedProperties":false}}},"unevaluatedProperties":false},{"type":"object","required":["id","status","audios","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"generation_stage":{"type":"string","enum":["text_generated","first_audio_ready","all_audios_ready","failed"]},"audios":{"type":"array","items":{"type":"object","required":["id"],"properties":{"id":{"type":"string"},"audio_url":{"type":"string","x-runapi-generated-media":true},"stream_audio_url":{"type":"string","x-runapi-generated-media":true},"image_url":{"type":"string","x-runapi-generated-media":true},"lyrics":{"type":"string"},"model_name":{"type":"string"},"title":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"duration":{"type":"number"}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/suno/text_to_sound":{"post":{"tags":["Suno"],"summary":"Suno Text-to-Sound","description":"Create an asynchronous task through the Suno text to sound endpoint.","operationId":"task_endpoint_suno_text_to_sound","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"prompt":{"type":"string","description":"Sound description (max 500 characters)."},"model":{"type":"string","description":"Model slug.","const":"suno-v5"},"sound_loop":{"type":"boolean","description":"When true, produce loopable audio. Default false."},"sound_tempo":{"type":"integer","description":"Tempo in BPM (1-300)."},"sound_key":{"type":"string","enum":["Cm","C#m","Dm","D#m","Em","Fm","F#m","Gm","G#m","Am","A#m","Bm","C","C#","D","D#","E","F","F#","G","G#","A","A#","B"],"description":"Musical key."},"grab_lyrics":{"type":"boolean","description":"Capture lyric subtitles. Default false."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."}},"additionalProperties":false,"required":["prompt","model"]},{"type":"object","properties":{"prompt":{"type":"string","description":"Sound description (max 500 characters)."},"model":{"type":"string","description":"Model slug.","const":"suno-v5.5"},"sound_loop":{"type":"boolean","description":"When true, produce loopable audio. Default false."},"sound_tempo":{"type":"integer","description":"Tempo in BPM (1-300)."},"sound_key":{"type":"string","enum":["Cm","C#m","Dm","D#m","Em","Fm","F#m","Gm","G#m","Am","A#m","Bm","C","C#","D","D#","E","F","F#","G","G#","A","A#","B"],"description":"Musical key."},"grab_lyrics":{"type":"boolean","description":"Capture lyric subtitles. Default false."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."}},"additionalProperties":false,"required":["prompt","model"]}]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/suno/text_to_sound/{id}":{"get":{"tags":["Suno"],"summary":"Retrieve Suno Text-to-Sound task","description":"Create an asynchronous task through the Suno text to sound endpoint.","operationId":"task_endpoint_suno_text_to_sound_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"generation_stage":{"type":"string","enum":["text_generated","first_audio_ready"]},"audios":{"type":"array","items":{"type":"object","required":["id"],"properties":{"id":{"type":"string"},"audio_url":{"type":"string","x-runapi-generated-media":true},"stream_audio_url":{"type":"string","x-runapi-generated-media":true},"image_url":{"type":"string","x-runapi-generated-media":true},"prompt":{"type":"string"},"model_name":{"type":"string"},"title":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"duration":{"type":"number"}},"unevaluatedProperties":false}}},"unevaluatedProperties":false},{"type":"object","required":["id","status","audios","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"generation_stage":{"type":"string","enum":["text_generated","first_audio_ready","all_audios_ready","failed"]},"audios":{"type":"array","items":{"type":"object","required":["id"],"properties":{"id":{"type":"string"},"audio_url":{"type":"string","x-runapi-generated-media":true},"stream_audio_url":{"type":"string","x-runapi-generated-media":true},"image_url":{"type":"string","x-runapi-generated-media":true},"prompt":{"type":"string"},"model_name":{"type":"string"},"title":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"duration":{"type":"number"}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/suno/voice_to_validation_phrase":{"post":{"tags":["Suno"],"summary":"Suno Voice-to-Validation-Phrase","description":"Create an asynchronous task through the Suno voice to validation phrase endpoint.","operationId":"task_endpoint_suno_voice_to_validation_phrase","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"voice_url":{"type":"string","description":"Source voice recording URL."},"vocal_start_seconds":{"type":"integer","description":"Start time (seconds) of the source vocal segment."},"vocal_end_seconds":{"type":"integer","description":"End time (seconds) of the source vocal segment. Must be greater than vocal_start_seconds."},"language":{"type":"string","enum":["en","zh","es","fr","pt","de","ja","ko","hi","ru"],"description":"Language code."},"callback_url":{"type":"string","description":"Webhook URL for async notifications."}},"additionalProperties":false,"required":["voice_url","vocal_start_seconds","vocal_end_seconds"]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/suno/voice_to_validation_phrase/{id}":{"get":{"tags":["Suno"],"summary":"Retrieve Suno Voice-to-Validation-Phrase task","description":"Create an asynchronous task through the Suno voice to validation phrase endpoint.","operationId":"task_endpoint_suno_voice_to_validation_phrase_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status","provider_status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"provider_status":{"type":"string","enum":["wait_processing","processing_validate"]},"validation_phrase":{"type":"string"}},"unevaluatedProperties":false},{"type":"object","required":["id","status","provider_status","validation_phrase","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"provider_status":{"type":"string"},"validation_phrase":{"type":"string"},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/timestamped_lyrics":{"post":{"tags":["Suno"],"summary":"Suno Timestamped-Lyrics","description":"Send a synchronous request through the Suno timestamped lyrics endpoint.","operationId":"task_endpoint_suno_timestamped_lyrics","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"source_audio_id":{"type":"string","description":"Audio id within the source Task, or a RunAPI audio resource id returned by a previous request."},"source_task_id":{"type":"string","description":"RunAPI Task id that produced the audio. Required when the audio id alone does not identify the source."}},"additionalProperties":false,"required":["source_audio_id"]}}}},"responses":{"200":{"description":"Sync success","content":{"application/json":{"schema":{"type":"object","required":["aligned_words","waveform_data","hoot_cer","is_streamed"],"properties":{"aligned_words":{"type":"array","items":{"type":"object","required":["word","success","start_time","end_time","palign"],"properties":{"word":{"type":"string"},"success":{"type":"boolean"},"start_time":{"type":"number"},"end_time":{"type":"number"},"palign":{"type":"number"}},"unevaluatedProperties":false}},"waveform_data":{"type":"array","items":{"type":"number"}},"hoot_cer":{"type":"number"},"is_streamed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/topaz/upscale_image":{"post":{"tags":["Topaz"],"summary":"Topaz Upscale-Image","description":"Create an asynchronous task through the Topaz upscale image endpoint.","operationId":"task_endpoint_topaz_upscale_image","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"topaz-upscale-image"},"source_image_url":{"type":"string","description":"Public source image URL."},"upscale_factor":{"type":"integer","enum":[1,2,4],"description":"Image upscale multiplier."},"callback_url":{"type":"string","description":"Webhook URL for terminal Task delivery."}},"additionalProperties":false,"required":["model","source_image_url","upscale_factor"]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/topaz/upscale_image/{id}":{"get":{"tags":["Topaz"],"summary":"Retrieve Topaz Upscale-Image task","description":"Create an asynchronous task through the Topaz upscale image endpoint.","operationId":"task_endpoint_topaz_upscale_image_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","images","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"images":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/topaz/upscale_video":{"post":{"tags":["Topaz"],"summary":"Topaz Upscale-Video","description":"Create an asynchronous task through the Topaz upscale video endpoint.","operationId":"task_endpoint_topaz_upscale_video","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"model":{"type":"string","description":"Model slug.","const":"topaz-upscale-video"},"source_video_url":{"type":"string","description":"Public source video URL."},"upscale_factor":{"type":"integer","enum":[1,2,4],"default":2,"description":"Video upscale multiplier."},"callback_url":{"type":"string","description":"Webhook URL for terminal Task delivery."}},"additionalProperties":false,"required":["model","source_video_url"]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/topaz/upscale_video/{id}":{"get":{"tags":["Topaz"],"summary":"Retrieve Topaz Upscale-Video task","description":"Create an asynchronous task through the Topaz upscale video endpoint.","operationId":"task_endpoint_topaz_upscale_video_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","videos","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"videos":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/veo_3_1/extend_video":{"post":{"tags":["Veo 3.1"],"summary":"Veo 3.1 Extend-Video","description":"Create an asynchronous task through the Veo 3.1 extend video endpoint.","operationId":"task_endpoint_veo_3_1_extend_video","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"source_task_id":{"type":"string"},"prompt":{"type":"string"},"seeds":{"type":"integer"},"watermark":{"type":"string"},"callback_url":{"type":"string"}},"additionalProperties":false,"required":["source_task_id"]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/veo_3_1/extend_video/{id}":{"get":{"tags":["Veo 3.1"],"summary":"Retrieve Veo 3.1 Extend-Video task","description":"Create an asynchronous task through the Veo 3.1 extend video endpoint.","operationId":"task_endpoint_veo_3_1_extend_video_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","videos","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"videos":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"sources":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string"}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/veo_3_1/text_to_video":{"post":{"tags":["Veo 3.1"],"summary":"Veo 3.1 Text-to-Video","description":"Create an asynchronous task through the Veo 3.1 text to video endpoint.","operationId":"task_endpoint_veo_3_1_text_to_video","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"prompt":{"type":"string"},"model":{"type":"string","const":"veo-3.1"},"input_mode":{"type":"string","enum":["text","first_and_last_frames","reference"]},"aspect_ratio":{"type":"string","enum":["16:9","9:16","auto"]},"duration_seconds":{"type":"integer","enum":[4,6,8]},"seeds":{"type":"integer"},"callback_url":{"type":"string"},"enable_translation":{"type":"boolean"},"watermark":{"type":"string"},"first_frame_image_url":{"type":"string"},"last_frame_image_url":{"type":"string"},"reference_image_urls":{"type":"array","maxItems":3,"minItems":1}},"additionalProperties":false,"required":["model"],"allOf":[{"if":{"properties":{"model":{"const":"veo-3.1-lite"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["seeds"]}},{"not":{"required":["output_resolution"]}}]}},{"if":{"allOf":[{"properties":{"model":{"const":"veo-3.1-lite"}},"required":["model"]},{"properties":{"input_mode":{"const":"reference"}},"required":["input_mode"]},{"properties":{"duration_seconds":{"const":4}},"required":["duration_seconds"]}]},"then":{"not":{"required":["duration_seconds"]}}},{"if":{"allOf":[{"properties":{"model":{"const":"veo-3.1-lite"}},"required":["model"]},{"properties":{"input_mode":{"const":"reference"}},"required":["input_mode"]},{"properties":{"duration_seconds":{"const":6}},"required":["duration_seconds"]}]},"then":{"not":{"required":["duration_seconds"]}}}]},{"type":"object","properties":{"prompt":{"type":"string"},"model":{"type":"string","const":"veo-3.1-fast"},"input_mode":{"type":"string","enum":["text","first_and_last_frames","reference"]},"aspect_ratio":{"type":"string","enum":["16:9","9:16","auto"]},"duration_seconds":{"type":"integer","enum":[4,6,8]},"seeds":{"type":"integer"},"callback_url":{"type":"string"},"enable_translation":{"type":"boolean"},"watermark":{"type":"string"},"first_frame_image_url":{"type":"string"},"last_frame_image_url":{"type":"string"},"reference_image_urls":{"type":"array","maxItems":3,"minItems":1}},"additionalProperties":false,"required":["model"],"allOf":[{"if":{"properties":{"model":{"const":"veo-3.1-lite"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["seeds"]}},{"not":{"required":["output_resolution"]}}]}},{"if":{"allOf":[{"properties":{"model":{"const":"veo-3.1-lite"}},"required":["model"]},{"properties":{"input_mode":{"const":"reference"}},"required":["input_mode"]},{"properties":{"duration_seconds":{"const":4}},"required":["duration_seconds"]}]},"then":{"not":{"required":["duration_seconds"]}}},{"if":{"allOf":[{"properties":{"model":{"const":"veo-3.1-lite"}},"required":["model"]},{"properties":{"input_mode":{"const":"reference"}},"required":["input_mode"]},{"properties":{"duration_seconds":{"const":6}},"required":["duration_seconds"]}]},"then":{"not":{"required":["duration_seconds"]}}}]},{"type":"object","properties":{"prompt":{"type":"string"},"model":{"type":"string","const":"veo-3.1-lite"},"input_mode":{"type":"string","enum":["text","first_and_last_frames","reference"],"default":"text"},"aspect_ratio":{"type":"string","enum":["16:9","9:16"]},"duration_seconds":{"type":"integer","enum":[4,6,8]},"callback_url":{"type":"string"},"enable_translation":{"type":"boolean"},"watermark":{"type":"string"},"first_frame_image_url":{"type":"string"},"last_frame_image_url":{"type":"string"},"reference_image_urls":{"type":"array","maxItems":3,"minItems":1}},"additionalProperties":false,"required":["model"],"allOf":[{"if":{"properties":{"model":{"const":"veo-3.1-lite"}},"required":["model"]},"then":{"allOf":[{"not":{"required":["seeds"]}},{"not":{"required":["output_resolution"]}}]}},{"if":{"allOf":[{"properties":{"model":{"const":"veo-3.1-lite"}},"required":["model"]},{"properties":{"input_mode":{"const":"reference"}},"required":["input_mode"]},{"properties":{"duration_seconds":{"const":4}},"required":["duration_seconds"]}]},"then":{"not":{"required":["duration_seconds"]}}},{"if":{"allOf":[{"properties":{"model":{"const":"veo-3.1-lite"}},"required":["model"]},{"properties":{"input_mode":{"const":"reference"}},"required":["input_mode"]},{"properties":{"duration_seconds":{"const":6}},"required":["duration_seconds"]}]},"then":{"not":{"required":["duration_seconds"]}}}]}]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/veo_3_1/text_to_video/{id}":{"get":{"tags":["Veo 3.1"],"summary":"Retrieve Veo 3.1 Text-to-Video task","description":"Create an asynchronous task through the Veo 3.1 text to video endpoint.","operationId":"task_endpoint_veo_3_1_text_to_video_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","videos","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"videos":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"sources":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string"}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/veo_3_1/upscale_video":{"post":{"tags":["Veo 3.1"],"summary":"Veo 3.1 Upscale-Video","description":"Create an asynchronous task through the Veo 3.1 upscale video endpoint.","operationId":"task_endpoint_veo_3_1_upscale_video","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"source_task_id":{"type":"string"},"output_resolution":{"type":"string","enum":["1080p","4k"],"default":"1080p"},"index":{"type":"integer"},"callback_url":{"type":"string"}},"additionalProperties":false}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/veo_3_1/upscale_video/{id}":{"get":{"tags":["Veo 3.1"],"summary":"Retrieve Veo 3.1 Upscale-Video task","description":"Create an asynchronous task through the Veo 3.1 upscale video endpoint.","operationId":"task_endpoint_veo_3_1_upscale_video_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","videos","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"videos":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"sources":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string"}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/voices":{"post":{"tags":["Suno"],"summary":"Suno Voices","description":"Send a synchronous request through the Suno voices endpoint.","operationId":"task_endpoint_suno_voices","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"source_audio_url":{"type":"string","description":"Public URL of the voice recording to clone."},"name":{"type":"string","description":"Voice name."}},"additionalProperties":false,"required":["source_audio_url"]}}}},"responses":{"200":{"description":"Sync success","content":{"application/json":{"schema":{"type":"object","required":["voice"],"properties":{"voice":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"unevaluatedProperties":false}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/volcengine_lip_sync/lip_sync_video":{"post":{"tags":["Volcengine Lip Sync"],"summary":"Volcengine Lip Sync Lip-Sync-Video","description":"Create an asynchronous task through the Volcengine Lip Sync lip sync video endpoint.","operationId":"task_endpoint_volcengine_lip_sync_lip_sync_video","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"model":{"type":"string","const":"volcengine-lip-sync"},"mode":{"type":"string","enum":["lite","basic"]},"source_video_url":{"type":"string"},"source_audio_url":{"type":"string"},"callback_url":{"type":"string"},"enable_vocal_separation":{"type":"boolean"},"enable_scene_detection":{"type":"boolean"},"align_audio":{"type":"boolean"},"align_audio_reverse":{"type":"boolean"},"template_start_seconds":{"type":"number","minimum":0}},"additionalProperties":false,"required":["mode","source_video_url","source_audio_url","model"],"allOf":[{"if":{"properties":{"mode":{"const":"lite"}},"required":["mode"]},"then":{"not":{"required":["enable_scene_detection"]}}},{"if":{"properties":{"mode":{"const":"basic"}},"required":["mode"]},"then":{"allOf":[{"not":{"required":["align_audio"]}},{"not":{"required":["align_audio_reverse"]}},{"not":{"required":["template_start_seconds"]}}]}},{"if":{"properties":{"align_audio_reverse":{"const":true}},"required":["align_audio_reverse"]},"then":{"required":["align_audio"]}}]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/volcengine_lip_sync/lip_sync_video/{id}":{"get":{"tags":["Volcengine Lip Sync"],"summary":"Retrieve Volcengine Lip Sync Lip-Sync-Video task","description":"Create an asynchronous task through the Volcengine Lip Sync lip sync video endpoint.","operationId":"task_endpoint_volcengine_lip_sync_lip_sync_video_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","videos","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"videos":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/wan/animate":{"post":{"tags":["Wan"],"summary":"Wan Animate","description":"Create an asynchronous task through the Wan animate endpoint.","operationId":"task_endpoint_wan_animate","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"model":{"type":"string","const":"wan-2.2-animate-move"},"source_image_url":{"type":"string"},"reference_video_url":{"type":"string"},"callback_url":{"type":"string"},"output_resolution":{"type":"string","enum":["480p","580p","720p"],"default":"480p"},"enable_safety_checker":{"type":"boolean"}},"additionalProperties":false,"required":["source_image_url","reference_video_url","model"]},{"type":"object","properties":{"model":{"type":"string","const":"wan-2.2-animate-replace"},"source_image_url":{"type":"string"},"reference_video_url":{"type":"string"},"callback_url":{"type":"string"},"output_resolution":{"type":"string","enum":["480p","580p","720p"],"default":"480p"},"enable_safety_checker":{"type":"boolean"}},"additionalProperties":false,"required":["source_image_url","reference_video_url","model"]}]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/wan/animate/{id}":{"get":{"tags":["Wan"],"summary":"Retrieve Wan Animate task","description":"Create an asynchronous task through the Wan animate endpoint.","operationId":"task_endpoint_wan_animate_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","videos","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"videos":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/wan/edit_video":{"post":{"tags":["Wan"],"summary":"Wan Edit-Video","description":"Create an asynchronous task through the Wan edit video endpoint.","operationId":"task_endpoint_wan_edit_video","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"model":{"type":"string","const":"wan-2.6-edit-video"},"source_video_url":{"type":"string"},"source_video_urls":{"type":"array"},"prompt":{"type":"string"},"callback_url":{"type":"string"},"negative_prompt":{"type":"string"},"reference_image_url":{"type":"string"},"output_resolution":{"type":"string","enum":["720p","1080p"],"default":"1080p"},"aspect_ratio":{"type":"string"},"duration_seconds":{"type":"integer"},"audio_setting":{"type":"string"},"enable_prompt_expansion":{"type":"boolean"},"watermark":{"type":"boolean"},"seed":{"type":"integer"},"enable_safety_checker":{"type":"boolean"},"audio":{"type":"boolean"},"multi_shots":{"type":"boolean","description":"Controls whether the generated video uses multiple shots with transitions instead of one continuous shot."}},"additionalProperties":false,"required":["source_video_urls","prompt","model"],"allOf":[{"if":{"properties":{"model":{"const":"wan-2.7-edit-video"}},"required":["model"]},"then":{"not":{"required":["multi_shots"]}}}]},{"type":"object","properties":{"model":{"type":"string","const":"wan-2.6-flash-edit-video"},"source_video_url":{"type":"string"},"source_video_urls":{"type":"array"},"prompt":{"type":"string"},"callback_url":{"type":"string"},"negative_prompt":{"type":"string"},"reference_image_url":{"type":"string"},"output_resolution":{"type":"string"},"aspect_ratio":{"type":"string"},"duration_seconds":{"type":"integer"},"audio_setting":{"type":"string"},"enable_prompt_expansion":{"type":"boolean"},"watermark":{"type":"boolean"},"seed":{"type":"integer"},"enable_safety_checker":{"type":"boolean"},"audio":{"type":"boolean"},"multi_shots":{"type":"boolean"}},"additionalProperties":false,"required":["source_video_urls","prompt","audio","model"],"allOf":[{"if":{"properties":{"model":{"const":"wan-2.7-edit-video"}},"required":["model"]},"then":{"not":{"required":["multi_shots"]}}}]},{"type":"object","properties":{"model":{"type":"string","const":"wan-2.7-edit-video"},"source_video_url":{"type":"string"},"source_video_urls":{"type":"array"},"prompt":{"type":"string"},"callback_url":{"type":"string"},"negative_prompt":{"type":"string"},"reference_image_url":{"type":"string"},"output_resolution":{"type":"string","enum":["720p","1080p"],"default":"1080p"},"aspect_ratio":{"type":"string","enum":["16:9","9:16","1:1","4:3","3:4"]},"duration_seconds":{"type":"integer"},"audio_setting":{"type":"string"},"enable_prompt_expansion":{"type":"boolean"},"watermark":{"type":"boolean"},"seed":{"type":"integer"},"enable_safety_checker":{"type":"boolean","description":"Enable the safety checker."},"audio":{"type":"boolean"}},"additionalProperties":false,"required":["source_video_url","model"],"allOf":[{"if":{"properties":{"model":{"const":"wan-2.7-edit-video"}},"required":["model"]},"then":{"not":{"required":["multi_shots"]}}}]}]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/wan/edit_video/{id}":{"get":{"tags":["Wan"],"summary":"Retrieve Wan Edit-Video task","description":"Create an asynchronous task through the Wan edit video endpoint.","operationId":"task_endpoint_wan_edit_video_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","videos","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"videos":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/wan/image_to_video":{"post":{"tags":["Wan"],"summary":"Wan Image-to-Video","description":"Create an asynchronous task through the Wan image to video endpoint.","operationId":"task_endpoint_wan_image_to_video","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"model":{"type":"string","const":"wan-2.2-a14b-image-to-video-turbo"},"prompt":{"type":"string"},"callback_url":{"type":"string"},"first_frame_image_url":{"type":"string"},"last_frame_image_url":{"type":"string"},"source_video_url":{"type":"string"},"duration_seconds":{"type":"integer"},"output_resolution":{"type":"string","enum":["480p","720p"],"default":"720p"},"aspect_ratio":{"type":"string"},"negative_prompt":{"type":"string"},"enable_prompt_expansion":{"type":"boolean"},"seed":{"type":"integer"},"acceleration":{"type":"string"},"enable_safety_checker":{"type":"boolean"},"watermark":{"type":"boolean"},"audio":{"type":"boolean"},"driving_audio_url":{"type":"string"},"background_audio_url":{"type":"string"},"ratio":{"type":"string"}},"additionalProperties":false,"required":["first_frame_image_url","model"],"allOf":[{"if":{"properties":{"model":{"const":"wan-2.2-a14b-image-to-video-turbo"}},"required":["model"]},"then":{"not":{"required":["multi_shots"]}}},{"if":{"properties":{"model":{"const":"wan-2.5-image-to-video"}},"required":["model"]},"then":{"not":{"required":["multi_shots"]}}},{"if":{"properties":{"model":{"const":"wan-2.6-flash-image-to-video"}},"required":["model"]},"then":{"not":{"required":["seed"]}}},{"if":{"properties":{"model":{"const":"wan-2.6-image-to-video"}},"required":["model"]},"then":{"not":{"required":["seed"]}}},{"if":{"properties":{"model":{"const":"wan-2.7-image-to-video"}},"required":["model"]},"then":{"not":{"required":["multi_shots"]}}}]},{"type":"object","properties":{"model":{"type":"string","const":"wan-2.5-image-to-video"},"prompt":{"type":"string"},"callback_url":{"type":"string"},"first_frame_image_url":{"type":"string"},"last_frame_image_url":{"type":"string"},"source_video_url":{"type":"string"},"duration_seconds":{"type":"integer","enum":[5,10]},"output_resolution":{"type":"string","enum":["720p","1080p"]},"aspect_ratio":{"type":"string"},"negative_prompt":{"type":"string"},"enable_prompt_expansion":{"type":"boolean"},"seed":{"type":"integer"},"acceleration":{"type":"string"},"enable_safety_checker":{"type":"boolean"},"watermark":{"type":"boolean"},"audio":{"type":"boolean"},"driving_audio_url":{"type":"string"},"background_audio_url":{"type":"string"},"ratio":{"type":"string"}},"additionalProperties":false,"required":["first_frame_image_url","duration_seconds","output_resolution","model"],"allOf":[{"if":{"properties":{"model":{"const":"wan-2.2-a14b-image-to-video-turbo"}},"required":["model"]},"then":{"not":{"required":["multi_shots"]}}},{"if":{"properties":{"model":{"const":"wan-2.5-image-to-video"}},"required":["model"]},"then":{"not":{"required":["multi_shots"]}}},{"if":{"properties":{"model":{"const":"wan-2.6-flash-image-to-video"}},"required":["model"]},"then":{"not":{"required":["seed"]}}},{"if":{"properties":{"model":{"const":"wan-2.6-image-to-video"}},"required":["model"]},"then":{"not":{"required":["seed"]}}},{"if":{"properties":{"model":{"const":"wan-2.7-image-to-video"}},"required":["model"]},"then":{"not":{"required":["multi_shots"]}}}]},{"type":"object","properties":{"model":{"type":"string","const":"wan-2.6-flash-image-to-video"},"prompt":{"type":"string"},"callback_url":{"type":"string"},"first_frame_image_url":{"type":"string"},"last_frame_image_url":{"type":"string"},"source_video_url":{"type":"string"},"duration_seconds":{"type":"integer","enum":[5,10,15],"default":5},"output_resolution":{"type":"string","enum":["720p","1080p"],"default":"1080p"},"aspect_ratio":{"type":"string"},"negative_prompt":{"type":"string"},"enable_prompt_expansion":{"type":"boolean"},"acceleration":{"type":"string"},"enable_safety_checker":{"type":"boolean"},"watermark":{"type":"boolean"},"audio":{"type":"boolean"},"multi_shots":{"type":"boolean"},"driving_audio_url":{"type":"string"},"background_audio_url":{"type":"string"},"ratio":{"type":"string"}},"additionalProperties":false,"required":["prompt","first_frame_image_url","audio","model"],"allOf":[{"if":{"properties":{"model":{"const":"wan-2.2-a14b-image-to-video-turbo"}},"required":["model"]},"then":{"not":{"required":["multi_shots"]}}},{"if":{"properties":{"model":{"const":"wan-2.5-image-to-video"}},"required":["model"]},"then":{"not":{"required":["multi_shots"]}}},{"if":{"properties":{"model":{"const":"wan-2.6-flash-image-to-video"}},"required":["model"]},"then":{"not":{"required":["seed"]}}},{"if":{"properties":{"model":{"const":"wan-2.6-image-to-video"}},"required":["model"]},"then":{"not":{"required":["seed"]}}},{"if":{"properties":{"model":{"const":"wan-2.7-image-to-video"}},"required":["model"]},"then":{"not":{"required":["multi_shots"]}}}]},{"type":"object","properties":{"model":{"type":"string","const":"wan-2.6-image-to-video"},"prompt":{"type":"string"},"callback_url":{"type":"string"},"first_frame_image_url":{"type":"string"},"last_frame_image_url":{"type":"string"},"source_video_url":{"type":"string"},"duration_seconds":{"type":"integer"},"output_resolution":{"type":"string","enum":["720p","1080p"],"default":"1080p"},"aspect_ratio":{"type":"string"},"negative_prompt":{"type":"string"},"enable_prompt_expansion":{"type":"boolean"},"acceleration":{"type":"string"},"enable_safety_checker":{"type":"boolean"},"watermark":{"type":"boolean"},"audio":{"type":"boolean"},"multi_shots":{"type":"boolean","description":"Controls whether the generated video uses multiple shots with transitions instead of one continuous shot."},"driving_audio_url":{"type":"string"},"background_audio_url":{"type":"string"},"ratio":{"type":"string"}},"additionalProperties":false,"required":["prompt","first_frame_image_url","model"],"allOf":[{"if":{"properties":{"model":{"const":"wan-2.2-a14b-image-to-video-turbo"}},"required":["model"]},"then":{"not":{"required":["multi_shots"]}}},{"if":{"properties":{"model":{"const":"wan-2.5-image-to-video"}},"required":["model"]},"then":{"not":{"required":["multi_shots"]}}},{"if":{"properties":{"model":{"const":"wan-2.6-flash-image-to-video"}},"required":["model"]},"then":{"not":{"required":["seed"]}}},{"if":{"properties":{"model":{"const":"wan-2.6-image-to-video"}},"required":["model"]},"then":{"not":{"required":["seed"]}}},{"if":{"properties":{"model":{"const":"wan-2.7-image-to-video"}},"required":["model"]},"then":{"not":{"required":["multi_shots"]}}}]},{"type":"object","properties":{"model":{"type":"string","const":"wan-2.7-image-to-video"},"prompt":{"type":"string"},"callback_url":{"type":"string"},"first_frame_image_url":{"type":"string"},"last_frame_image_url":{"type":"string"},"source_video_url":{"type":"string"},"duration_seconds":{"type":"integer"},"output_resolution":{"type":"string","enum":["720p","1080p"],"default":"1080p"},"aspect_ratio":{"type":"string"},"negative_prompt":{"type":"string"},"enable_prompt_expansion":{"type":"boolean"},"seed":{"type":"integer"},"acceleration":{"type":"string"},"enable_safety_checker":{"type":"boolean"},"watermark":{"type":"boolean"},"audio":{"type":"boolean"},"driving_audio_url":{"type":"string"},"background_audio_url":{"type":"string"},"ratio":{"type":"string"}},"additionalProperties":false,"required":["prompt","model"],"allOf":[{"if":{"properties":{"model":{"const":"wan-2.2-a14b-image-to-video-turbo"}},"required":["model"]},"then":{"not":{"required":["multi_shots"]}}},{"if":{"properties":{"model":{"const":"wan-2.5-image-to-video"}},"required":["model"]},"then":{"not":{"required":["multi_shots"]}}},{"if":{"properties":{"model":{"const":"wan-2.6-flash-image-to-video"}},"required":["model"]},"then":{"not":{"required":["seed"]}}},{"if":{"properties":{"model":{"const":"wan-2.6-image-to-video"}},"required":["model"]},"then":{"not":{"required":["seed"]}}},{"if":{"properties":{"model":{"const":"wan-2.7-image-to-video"}},"required":["model"]},"then":{"not":{"required":["multi_shots"]}}}]}]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/wan/image_to_video/{id}":{"get":{"tags":["Wan"],"summary":"Retrieve Wan Image-to-Video task","description":"Create an asynchronous task through the Wan image to video endpoint.","operationId":"task_endpoint_wan_image_to_video_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","videos","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"videos":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/wan/speech_to_video":{"post":{"tags":["Wan"],"summary":"Wan Speech-to-Video","description":"Create an asynchronous task through the Wan speech to video endpoint.","operationId":"task_endpoint_wan_speech_to_video","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"model":{"type":"string","const":"wan-2.2-a14b-speech-to-video-turbo"},"source_image_url":{"type":"string"},"source_audio_url":{"type":"string"},"prompt":{"type":"string"},"callback_url":{"type":"string"},"num_frames":{"type":"integer"},"frames_per_second":{"type":"integer"},"output_resolution":{"type":"string","enum":["480p","580p","720p"],"default":"480p"},"negative_prompt":{"type":"string"},"seed":{"type":"integer"},"num_inference_steps":{"type":"integer"},"guidance_scale":{"type":"number"},"shift":{"type":"number"},"enable_safety_checker":{"type":"boolean"}},"additionalProperties":false,"required":["source_image_url","source_audio_url","prompt","model"]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/wan/speech_to_video/{id}":{"get":{"tags":["Wan"],"summary":"Retrieve Wan Speech-to-Video task","description":"Create an asynchronous task through the Wan speech to video endpoint.","operationId":"task_endpoint_wan_speech_to_video_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","videos","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"videos":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/wan/text_to_image":{"post":{"tags":["Wan"],"summary":"Wan Text-to-Image","description":"Create an asynchronous task through the Wan text to image endpoint.","operationId":"task_endpoint_wan_text_to_image","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"model":{"type":"string","const":"wan-2.7-image"},"prompt":{"type":"string"},"callback_url":{"type":"string"},"aspect_ratio":{"type":"string","enum":["1:1","16:9","4:3","21:9","3:4","9:16","8:1","1:8"]},"output_resolution":{"type":"string","enum":["1k","2k"]},"output_count":{"type":"integer"},"enable_sequential":{"type":"boolean"},"thinking_mode":{"type":"boolean"},"watermark":{"type":"boolean"},"seed":{"type":"integer"},"enable_safety_checker":{"type":"boolean"},"source_image_urls":{"type":"array"},"color_palette":{"type":"array"},"bbox_list":{"type":"array"}},"additionalProperties":false,"required":["model"]},{"type":"object","properties":{"model":{"type":"string","const":"wan-2.7-image-pro"},"prompt":{"type":"string"},"callback_url":{"type":"string"},"aspect_ratio":{"type":"string","enum":["1:1","16:9","4:3","21:9","3:4","9:16","8:1","1:8"]},"output_resolution":{"type":"string","enum":["1k","2k","4k"]},"output_count":{"type":"integer"},"enable_sequential":{"type":"boolean"},"thinking_mode":{"type":"boolean"},"watermark":{"type":"boolean"},"seed":{"type":"integer"},"enable_safety_checker":{"type":"boolean"},"source_image_urls":{"type":"array"},"color_palette":{"type":"array"},"bbox_list":{"type":"array"}},"additionalProperties":false,"required":["model"]}]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/wan/text_to_image/{id}":{"get":{"tags":["Wan"],"summary":"Retrieve Wan Text-to-Image task","description":"Create an asynchronous task through the Wan text to image endpoint.","operationId":"task_endpoint_wan_text_to_image_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","images","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"images":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/wan/text_to_video":{"post":{"tags":["Wan"],"summary":"Wan Text-to-Video","description":"Create an asynchronous task through the Wan text to video endpoint.","operationId":"task_endpoint_wan_text_to_video","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"model":{"type":"string","const":"wan-2.2-a14b-text-to-video-turbo"},"prompt":{"type":"string"},"callback_url":{"type":"string"},"duration_seconds":{"type":"integer"},"output_resolution":{"type":"string","enum":["480p","580p","720p"],"default":"720p"},"aspect_ratio":{"type":"string"},"ratio":{"type":"string"},"negative_prompt":{"type":"string"},"reference_image_urls":{"type":"array"},"reference_video_urls":{"type":"array"},"first_frame_image_url":{"type":"string"},"reference_audio_url":{"type":"string"},"enable_prompt_expansion":{"type":"boolean"},"seed":{"type":"integer"},"acceleration":{"type":"string"},"enable_safety_checker":{"type":"boolean"},"watermark":{"type":"boolean"},"background_audio_url":{"type":"string"}},"additionalProperties":false,"required":["model"],"allOf":[{"if":{"properties":{"model":{"const":"wan-2.2-a14b-text-to-video-turbo"}},"required":["model"]},"then":{"not":{"required":["multi_shots"]}}},{"if":{"properties":{"model":{"const":"wan-2.5-text-to-video"}},"required":["model"]},"then":{"not":{"required":["multi_shots"]}}},{"if":{"properties":{"model":{"const":"wan-2.6-text-to-video"}},"required":["model"]},"then":{"not":{"required":["seed"]}}},{"if":{"properties":{"model":{"const":"wan-2.7-r2v"}},"required":["model"]},"then":{"not":{"required":["multi_shots"]}}},{"if":{"properties":{"model":{"const":"wan-2.7-text-to-video"}},"required":["model"]},"then":{"not":{"required":["multi_shots"]}}}]},{"type":"object","properties":{"model":{"type":"string","const":"wan-2.5-text-to-video"},"prompt":{"type":"string"},"callback_url":{"type":"string"},"duration_seconds":{"type":"integer","enum":[5,10]},"output_resolution":{"type":"string","enum":["720p","1080p"]},"aspect_ratio":{"type":"string"},"ratio":{"type":"string"},"negative_prompt":{"type":"string"},"reference_image_urls":{"type":"array"},"reference_video_urls":{"type":"array"},"first_frame_image_url":{"type":"string"},"reference_audio_url":{"type":"string"},"enable_prompt_expansion":{"type":"boolean"},"seed":{"type":"integer"},"acceleration":{"type":"string"},"enable_safety_checker":{"type":"boolean"},"watermark":{"type":"boolean"},"background_audio_url":{"type":"string"}},"additionalProperties":false,"required":["output_resolution","model"],"allOf":[{"if":{"properties":{"model":{"const":"wan-2.2-a14b-text-to-video-turbo"}},"required":["model"]},"then":{"not":{"required":["multi_shots"]}}},{"if":{"properties":{"model":{"const":"wan-2.5-text-to-video"}},"required":["model"]},"then":{"not":{"required":["multi_shots"]}}},{"if":{"properties":{"model":{"const":"wan-2.6-text-to-video"}},"required":["model"]},"then":{"not":{"required":["seed"]}}},{"if":{"properties":{"model":{"const":"wan-2.7-r2v"}},"required":["model"]},"then":{"not":{"required":["multi_shots"]}}},{"if":{"properties":{"model":{"const":"wan-2.7-text-to-video"}},"required":["model"]},"then":{"not":{"required":["multi_shots"]}}}]},{"type":"object","properties":{"model":{"type":"string","const":"wan-2.6-text-to-video"},"prompt":{"type":"string"},"callback_url":{"type":"string"},"duration_seconds":{"type":"integer"},"output_resolution":{"type":"string","enum":["720p","1080p"],"default":"1080p"},"aspect_ratio":{"type":"string"},"ratio":{"type":"string"},"negative_prompt":{"type":"string"},"reference_image_urls":{"type":"array"},"reference_video_urls":{"type":"array"},"first_frame_image_url":{"type":"string"},"reference_audio_url":{"type":"string"},"enable_prompt_expansion":{"type":"boolean"},"acceleration":{"type":"string"},"enable_safety_checker":{"type":"boolean"},"watermark":{"type":"boolean"},"background_audio_url":{"type":"string"},"multi_shots":{"type":"boolean","description":"Controls whether the generated video uses multiple shots with transitions instead of one continuous shot."}},"additionalProperties":false,"required":["model"],"allOf":[{"if":{"properties":{"model":{"const":"wan-2.2-a14b-text-to-video-turbo"}},"required":["model"]},"then":{"not":{"required":["multi_shots"]}}},{"if":{"properties":{"model":{"const":"wan-2.5-text-to-video"}},"required":["model"]},"then":{"not":{"required":["multi_shots"]}}},{"if":{"properties":{"model":{"const":"wan-2.6-text-to-video"}},"required":["model"]},"then":{"not":{"required":["seed"]}}},{"if":{"properties":{"model":{"const":"wan-2.7-r2v"}},"required":["model"]},"then":{"not":{"required":["multi_shots"]}}},{"if":{"properties":{"model":{"const":"wan-2.7-text-to-video"}},"required":["model"]},"then":{"not":{"required":["multi_shots"]}}}]},{"type":"object","properties":{"model":{"type":"string","const":"wan-2.7-r2v"},"prompt":{"type":"string"},"callback_url":{"type":"string"},"duration_seconds":{"type":"integer","maximum":10,"minimum":2,"default":5},"output_resolution":{"type":"string","enum":["720p","1080p"],"default":"1080p"},"aspect_ratio":{"type":"string","enum":["16:9","9:16","1:1","4:3","3:4"]},"ratio":{"type":"string"},"negative_prompt":{"type":"string"},"reference_image_urls":{"type":"array"},"reference_video_urls":{"type":"array"},"first_frame_image_url":{"type":"string"},"reference_audio_url":{"type":"string"},"enable_prompt_expansion":{"type":"boolean"},"seed":{"type":"integer"},"acceleration":{"type":"string"},"enable_safety_checker":{"type":"boolean"},"watermark":{"type":"boolean"},"background_audio_url":{"type":"string"}},"additionalProperties":false,"required":["model"],"allOf":[{"if":{"properties":{"model":{"const":"wan-2.2-a14b-text-to-video-turbo"}},"required":["model"]},"then":{"not":{"required":["multi_shots"]}}},{"if":{"properties":{"model":{"const":"wan-2.5-text-to-video"}},"required":["model"]},"then":{"not":{"required":["multi_shots"]}}},{"if":{"properties":{"model":{"const":"wan-2.6-text-to-video"}},"required":["model"]},"then":{"not":{"required":["seed"]}}},{"if":{"properties":{"model":{"const":"wan-2.7-r2v"}},"required":["model"]},"then":{"not":{"required":["multi_shots"]}}},{"if":{"properties":{"model":{"const":"wan-2.7-text-to-video"}},"required":["model"]},"then":{"not":{"required":["multi_shots"]}}}]},{"type":"object","properties":{"model":{"type":"string","const":"wan-2.7-text-to-video"},"prompt":{"type":"string"},"callback_url":{"type":"string"},"duration_seconds":{"type":"integer"},"output_resolution":{"type":"string","enum":["720p","1080p"],"default":"1080p"},"aspect_ratio":{"type":"string"},"ratio":{"type":"string"},"negative_prompt":{"type":"string"},"reference_image_urls":{"type":"array"},"reference_video_urls":{"type":"array"},"first_frame_image_url":{"type":"string"},"reference_audio_url":{"type":"string"},"enable_prompt_expansion":{"type":"boolean"},"seed":{"type":"integer"},"acceleration":{"type":"string"},"enable_safety_checker":{"type":"boolean"},"watermark":{"type":"boolean"},"background_audio_url":{"type":"string"}},"additionalProperties":false,"required":["model"],"allOf":[{"if":{"properties":{"model":{"const":"wan-2.2-a14b-text-to-video-turbo"}},"required":["model"]},"then":{"not":{"required":["multi_shots"]}}},{"if":{"properties":{"model":{"const":"wan-2.5-text-to-video"}},"required":["model"]},"then":{"not":{"required":["multi_shots"]}}},{"if":{"properties":{"model":{"const":"wan-2.6-text-to-video"}},"required":["model"]},"then":{"not":{"required":["seed"]}}},{"if":{"properties":{"model":{"const":"wan-2.7-r2v"}},"required":["model"]},"then":{"not":{"required":["multi_shots"]}}},{"if":{"properties":{"model":{"const":"wan-2.7-text-to-video"}},"required":["model"]},"then":{"not":{"required":["multi_shots"]}}}]}]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/wan/text_to_video/{id}":{"get":{"tags":["Wan"],"summary":"Retrieve Wan Text-to-Video task","description":"Create an asynchronous task through the Wan text to video endpoint.","operationId":"task_endpoint_wan_text_to_video_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","videos","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"videos":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/z_image/text_to_image":{"post":{"tags":["Z Image"],"summary":"Z Image Text-to-Image","description":"Create an asynchronous task through the Z Image text to image endpoint.","operationId":"task_endpoint_z_image_text_to_image","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"model":{"type":"string","const":"z-image"},"prompt":{"type":"string","maxLength":1000,"minLength":1},"aspect_ratio":{"type":"string","enum":["1:1","4:3","3:4","16:9","9:16"]},"enable_safety_checker":{"type":"boolean"},"callback_url":{"type":"string"}},"additionalProperties":false,"required":["prompt","aspect_ratio","model"]}}}},"responses":{"202":{"description":"Create acceptance","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"task_replayed":{"type":"boolean"}},"unevaluatedProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false},{"type":"object","required":["error","errors"],"properties":{"error":{"type":"string","description":"Human-readable validation summary."},"errors":{"type":"object","description":"Validation messages keyed by public request field, with an array of human-readable strings for each field.","additionalProperties":{"type":"array","items":{"type":"string"}}}},"unevaluatedProperties":false}]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/api/v1/z_image/text_to_image/{id}":{"get":{"tags":["Z Image"],"summary":"Retrieve Z Image Text-to-Image task","description":"Create an asynchronous task through the Z Image text to image endpoint.","operationId":"task_endpoint_z_image_text_to_image_retrieve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling processing or Polling completed or Polling failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]}},"unevaluatedProperties":false},{"type":"object","required":["id","status","images","usage"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["completed"]},"images":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","x-runapi-generated-media":true}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"cost":{"type":"number"}},"unevaluatedProperties":false}},"unevaluatedProperties":false},{"type":"object","required":["id","status","error"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"error":{"type":"string"}},"unevaluatedProperties":false}]}}}},"401":{"description":"Polling authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}},"404":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"unevaluatedProperties":false}}}}}}},"/v1/audio/transcriptions":{"post":{"tags":["OpenAI Transcription"],"summary":"OpenAI Transcription Speech-to-Text","description":"Send a synchronous request through the OpenAI Transcription speech to text endpoint.","operationId":"task_endpoint_openai_transcription_speech_to_text","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"file":{"type":"string","description":"Audio file upload, up to 25 MB."},"model":{"type":"string","enum":["gpt-transcribe"],"description":"Transcription model.","const":"gpt-transcribe"},"prompt":{"type":"string","description":"Optional text that guides transcription style and vocabulary."},"language":{"type":"string","description":"Audio language as an ISO-639-1 code."},"languages":{"type":"array","items":{"type":"string"},"description":"Candidate audio languages as ISO-639-1 codes."},"keywords":{"type":"array","items":{"type":"string"},"description":"Terms that should receive additional recognition guidance."},"temperature":{"type":"number","maximum":1,"minimum":0,"description":"Sampling temperature from 0 to 1."},"response_format":{"type":"string","enum":["json","text"],"description":"Response body format."},"stream":{"type":"boolean","description":"Whether to request a streamed response when supported."}},"additionalProperties":false,"required":["file","model"]},{"type":"object","properties":{"file":{"type":"string","description":"Audio file upload, up to 25 MB."},"model":{"type":"string","enum":["whisper-1"],"description":"Transcription model.","const":"whisper-1"},"prompt":{"type":"string","description":"Optional text that guides transcription style and vocabulary."},"language":{"type":"string","description":"Audio language as an ISO-639-1 code."},"temperature":{"type":"number","maximum":1,"minimum":0,"description":"Sampling temperature from 0 to 1."},"response_format":{"type":"string","enum":["json","text","srt","verbose_json","vtt"],"description":"Response body format."},"stream":{"type":"boolean","description":"Whether to request a streamed response when supported."},"timestamp_granularities":{"type":"array","items":{"enum":["word","segment"],"type":"string"},"maxItems":2,"description":"Timestamp detail included with verbose JSON responses."}},"additionalProperties":false,"required":["file","model"]}]}}}},"responses":{"200":{"description":"Sync success","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["text"],"properties":{"text":{"type":"string"},"task":{"type":"string"},"language":{"type":"string"},"duration":{"type":"number"},"words":{"type":"array","items":{"type":"object","required":["word","start","end"],"properties":{"word":{"type":"string"},"start":{"type":"number"},"end":{"type":"number"}},"unevaluatedProperties":false}},"segments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"seek":{"type":"integer"},"start":{"type":"number"},"end":{"type":"number"},"text":{"type":"string"},"tokens":{"type":"array","items":{"type":"integer"}},"temperature":{"type":"number"},"avg_logprob":{"type":"number"},"compression_ratio":{"type":"number"},"no_speech_prob":{"type":"number"}},"unevaluatedProperties":false}},"usage":{"type":"object","properties":{"type":{"type":"string"},"seconds":{"type":"number"},"input_tokens":{"type":"integer"},"input_token_details":{"type":"object","properties":{"text_tokens":{"type":"integer"},"audio_tokens":{"type":"integer"}},"unevaluatedProperties":false},"output_tokens":{"type":"integer"},"total_tokens":{"type":"integer"}},"unevaluatedProperties":false},"logprobs":{"type":"array","items":{"type":"object","properties":{"token":{"type":"string"},"logprob":{"type":"number"},"bytes":{"type":"array","items":{"type":"integer"}}},"unevaluatedProperties":false}}},"unevaluatedProperties":false},{"type":"string"}]}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"window":{"type":"string","enum":["1h","1d","7d","daily","weekly","monthly","lifetime"]},"limit_cents":{"type":"integer"},"used_cents":{"type":"integer"},"reset_at":{"type":["string","null"],"format":"date-time"}},"unevaluatedProperties":false}},"unevaluatedProperties":false}}}},"401":{"description":"Authentication required"},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"window":{"type":"string","enum":["1h","1d","7d","daily","weekly","monthly","lifetime"]},"limit_cents":{"type":"integer"},"used_cents":{"type":"integer"},"reset_at":{"type":["string","null"],"format":"date-time"}},"unevaluatedProperties":false}},"unevaluatedProperties":false}}}},"409":{"description":"Request conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"window":{"type":"string","enum":["1h","1d","7d","daily","weekly","monthly","lifetime"]},"limit_cents":{"type":"integer"},"used_cents":{"type":"integer"},"reset_at":{"type":["string","null"],"format":"date-time"}},"unevaluatedProperties":false}},"unevaluatedProperties":false}}}},"429":{"description":"Api token credit limit exceeded or Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"window":{"type":"string","enum":["1h","1d","7d","daily","weekly","monthly","lifetime"]},"limit_cents":{"type":"integer"},"used_cents":{"type":"integer"},"reset_at":{"type":["string","null"],"format":"date-time"}},"unevaluatedProperties":false}},"unevaluatedProperties":false}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"window":{"type":"string","enum":["1h","1d","7d","daily","weekly","monthly","lifetime"]},"limit_cents":{"type":"integer"},"used_cents":{"type":"integer"},"reset_at":{"type":["string","null"],"format":"date-time"}},"unevaluatedProperties":false}},"unevaluatedProperties":false}}}},"504":{"description":"Timeout error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"window":{"type":"string","enum":["1h","1d","7d","daily","weekly","monthly","lifetime"]},"limit_cents":{"type":"integer"},"used_cents":{"type":"integer"},"reset_at":{"type":["string","null"],"format":"date-time"}},"unevaluatedProperties":false}},"unevaluatedProperties":false}}}}}}},"/v1/chat/completions":{"post":{"tags":["OpenAI"],"summary":"OpenAI Chat Completions","operationId":"protocol_operation_openai_chat_completions","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["model","messages"],"properties":{"model":{"type":"string","description":"RunAPI model identifier returned by the compatible model catalog."},"messages":{"type":"array","description":"Conversation messages in OpenAI Chat Completions format.","items":{"type":"object","required":["role"],"properties":{"role":{"type":"string"},"content":{"type":["string","array"]}},"additionalProperties":true}},"stream":{"type":["boolean","null"],"default":false,"description":"Return Chat Completions chunks as server-sent events."},"max_tokens":{"type":["integer","null"],"description":"Compatibility generation token limit retained for supported models; model support can vary."},"temperature":{"type":["number","null"],"description":"Sampling temperature; model support can vary."},"top_p":{"type":["number","null"],"description":"Nucleus sampling probability; model support can vary."},"tools":{"type":"array","description":"Tools the model may call."}},"additionalProperties":true}}}},"responses":{"200":{"description":"Success or Streaming","content":{"application/json":{"schema":{"type":"object","required":["id","object","created","model","choices"],"properties":{"id":{"type":"string"},"object":{"type":"string","const":"chat.completion"},"created":{"type":"integer"},"model":{"type":"string"},"choices":{"type":"array"},"usage":{"type":"object","properties":{"prompt_tokens":{"type":"integer"},"completion_tokens":{"type":"integer"},"total_tokens":{"type":"integer"}},"additionalProperties":true}},"additionalProperties":true}},"text/event-stream":{"schema":{"type":"object","required":["id","object","choices"],"properties":{"id":{"type":"string"},"object":{"type":"string","const":"chat.completion.chunk"},"created":{"type":"integer"},"model":{"type":"string"},"choices":{"type":"array"},"usage":{"oneOf":[{"type":"object","required":["prompt_tokens","completion_tokens","total_tokens"],"properties":{"prompt_tokens":{"type":"integer"},"completion_tokens":{"type":"integer"},"total_tokens":{"type":"integer"}},"additionalProperties":true},{"type":"null"}]}},"additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"type":{"type":"string"},"param":{"type":["string","null"]},"code":{"type":["string","null"]}},"additionalProperties":true}},"additionalProperties":true}}}}}}},"/v1/embeddings":{"post":{"tags":["OpenAI"],"summary":"OpenAI Embeddings","operationId":"protocol_operation_openai_embeddings","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["model","input"],"properties":{"model":{"type":"string","description":"RunAPI embedding model identifier."},"input":{"type":["string","array"],"description":"Text or token arrays to embed."},"encoding_format":{"type":"string","description":"Format used for returned embedding vectors."},"dimensions":{"type":"integer","description":"Requested output vector dimensions for models that support it."}},"additionalProperties":true}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["object","data","model","usage"],"properties":{"object":{"type":"string","const":"list"},"data":{"type":"array"},"model":{"type":"string"},"usage":{"type":"object","properties":{"prompt_tokens":{"type":"integer"},"total_tokens":{"type":"integer"}},"additionalProperties":true}},"additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"type":{"type":"string"},"param":{"type":["string","null"]},"code":{"type":["string","null"]}},"additionalProperties":true}},"additionalProperties":true}}}}}}},"/v1/live/webrtc":{"post":{"tags":["OpenAI"],"summary":"OpenAI Live","operationId":"protocol_operation_openai_live","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["model","transport","sdp"],"properties":{"model":{"type":"string","description":"RunAPI model identifier; Live currently supports gpt-live-1."},"transport":{"type":"string","const":"webrtc","description":"WebRTC session negotiation transport."},"sdp":{"type":"string","minLength":1,"description":"Client SDP offer for the WebRTC session."},"delegation":{"type":["object","null"],"description":"Optional client or Responses delegation contract, in the provider's shape.","properties":{"type":{"type":"string","enum":["client","responses"]},"responses":{"type":"object","description":"Backend settings for delegated work when type is responses.","properties":{"model":{"type":"string","minLength":1,"description":"Responses model that runs delegated work."},"instructions":{"type":"string","description":"Backend prompt for delegated work."},"tools":{"type":"array","description":"Hosted Responses tools the delegated call may use.","items":{"type":"object","required":["type"],"properties":{"type":{"type":"string","enum":["web_search","web_search_preview","file_search","computer_use_preview"]}},"additionalProperties":true}},"tool_choice":{"type":["string","object"],"description":"Which delegated tools the backend may use."},"parallel_tool_calls":{"type":"boolean","description":"Allow independent delegated tool calls in one turn."},"max_output_tokens":{"type":"integer","description":"Output token budget for the delegated response; at least 16."},"service_tier":{"type":"string","description":"Service tier requested for the delegated response."},"reasoning":{"type":"object","additionalProperties":true,"description":"Reasoning settings for the delegated model."},"text":{"type":"object","additionalProperties":true,"description":"Text output settings for the delegated response."}},"additionalProperties":true},"tools":{"type":"array","description":"Client-owned function tools when type is client.","items":{"type":"object","required":["type"],"properties":{"type":{"type":"string","const":"function"}},"additionalProperties":true}}},"additionalProperties":true}},"additionalProperties":true}}}},"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["session","transport"],"properties":{"session":{"type":"object","additionalProperties":true},"transport":{"type":"object","additionalProperties":true}},"additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"type":{"type":"string"},"param":{"type":["string","null"]},"code":{"type":["string","null"]}},"additionalProperties":true}},"additionalProperties":true}}}}}}},"/v1/messages":{"post":{"tags":["Anthropic"],"summary":"Anthropic Messages","operationId":"protocol_operation_anthropic_messages","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["model","max_tokens","messages"],"properties":{"model":{"type":"string","description":"RunAPI model identifier returned by the compatible model catalog."},"max_tokens":{"type":"integer","description":"Maximum number of tokens to generate before stopping."},"messages":{"type":"array","description":"Conversation turns in Anthropic Messages format.","items":{"type":"object","required":["role","content"],"properties":{"role":{"type":"string"},"content":{"type":["string","array"]}},"additionalProperties":true}},"stream":{"type":"boolean","default":false,"description":"Return typed Messages events as server-sent events."},"system":{"type":["string","array"],"description":"System instructions supplied separately from conversational messages."},"temperature":{"type":"number","description":"Sampling temperature; model support can vary."},"top_p":{"type":"number","description":"Nucleus sampling probability; model support can vary."},"tools":{"type":"array","description":"Tools the model may call."}},"additionalProperties":true}}}},"responses":{"200":{"description":"Success or Streaming","content":{"application/json":{"schema":{"type":"object","required":["id","type","role","content","model","stop_reason","usage"],"properties":{"id":{"type":"string"},"type":{"type":"string","const":"message"},"role":{"type":"string","const":"assistant"},"content":{"type":"array"},"model":{"type":"string"},"stop_reason":{"type":["string","null"]},"usage":{"type":"object","properties":{"input_tokens":{"type":"integer"},"output_tokens":{"type":"integer"}},"additionalProperties":true}},"additionalProperties":true}},"text/event-stream":{"schema":{"oneOf":[{"type":"object","required":["type","message"],"properties":{"type":{"type":"string","const":"message_start"},"message":{"type":"object"}},"additionalProperties":true},{"type":"object","required":["type","index","delta"],"properties":{"type":{"type":"string","const":"content_block_delta"},"index":{"type":"integer"},"delta":{"type":"object"}},"additionalProperties":true},{"type":"object","required":["type","delta","usage"],"properties":{"type":{"type":"string","const":"message_delta"},"delta":{"type":"object"},"usage":{"type":"object","properties":{"output_tokens":{"type":"integer"}},"additionalProperties":true}},"additionalProperties":true},{"type":"object","required":["type"],"properties":{"type":{"type":"string","const":"message_stop"}},"additionalProperties":true}]}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["type","error"],"properties":{"type":{"type":"string","const":"error"},"error":{"type":"object","properties":{"type":{"type":"string"},"message":{"type":"string"}},"additionalProperties":true},"request_id":{"type":"string"}},"additionalProperties":true}}}}}}},"/v1/moderations":{"post":{"tags":["OpenAI"],"summary":"OpenAI Moderations","operationId":"protocol_operation_openai_moderations","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"model":{"type":"string","description":"RunAPI moderation model identifier; defaults to omni-moderation-latest."},"input":{"type":["string","array"],"description":"Text or mixed text and image content to classify.","items":{"oneOf":[{"type":"string"},{"type":"object","additionalProperties":true}]}}},"additionalProperties":true}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["id","model","results"],"properties":{"id":{"type":"string","minLength":1},"model":{"type":"string","minLength":1},"results":{"type":"array","minItems":1,"items":{"type":"object","required":["flagged","categories","category_scores"],"properties":{"flagged":{"type":"boolean"},"categories":{"type":"object","additionalProperties":true},"category_scores":{"type":"object","additionalProperties":true},"category_applied_input_types":{"type":"object","additionalProperties":true}},"additionalProperties":true}}},"additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"type":{"type":"string"},"param":{"type":["string","null"]},"code":{"type":["string","null"]}},"additionalProperties":true}},"additionalProperties":true}}}}}}},"/v1/responses":{"post":{"tags":["OpenAI"],"summary":"OpenAI Responses","operationId":"protocol_operation_openai_responses","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["model"],"properties":{"model":{"type":"string","description":"RunAPI model identifier returned by the compatible model catalog."},"input":{"type":["string","array"],"description":"Text, message items, or tool results provided to the model."},"instructions":{"type":["string","null"],"description":"System or developer instructions for this response."},"max_output_tokens":{"type":["integer","null"],"description":"Maximum number of output tokens, including visible and reasoning tokens."},"stream":{"type":["boolean","null"],"default":false,"description":"Return typed Responses events as server-sent events."},"tools":{"type":"array","description":"Tools the model may call."},"moderation":{"type":["object","null"],"description":"Return independent moderation signals for the current input and complete output.","properties":{"model":{"type":"string","enum":["omni-moderation-latest"]},"policy":{"type":["object","null"],"properties":{"input":{"type":["object","null"],"properties":{"mode":{"type":"string","enum":["score","block"]}},"additionalProperties":true},"output":{"type":["object","null"],"properties":{"mode":{"type":"string","enum":["score","block"]}},"additionalProperties":true}},"additionalProperties":true}},"additionalProperties":true}},"additionalProperties":true}}}},"responses":{"200":{"description":"Success or Streaming","content":{"application/json":{"schema":{"type":"object","required":["id","object","status","model","output"],"properties":{"id":{"type":"string"},"object":{"type":"string","const":"response"},"status":{"type":"string"},"model":{"type":"string"},"output":{"type":"array"},"usage":{"type":"object","properties":{"input_tokens":{"type":"integer"},"output_tokens":{"type":"integer"},"total_tokens":{"type":"integer"}},"additionalProperties":true},"moderation":{"type":"object","properties":{"input":{"oneOf":[{"type":"object","required":["type","model","flagged","categories","category_scores","category_applied_input_types"],"properties":{"type":{"type":"string","const":"moderation_result"},"model":{"type":"string","const":"omni-moderation-latest"},"flagged":{"type":"boolean"},"categories":{"type":"object","additionalProperties":true},"category_scores":{"type":"object","additionalProperties":true},"category_applied_input_types":{"type":"object","additionalProperties":true}},"additionalProperties":true},{"type":"object","required":["type","code","message"],"properties":{"type":{"type":"string","const":"error"},"code":{"type":"string"},"message":{"type":"string"}},"additionalProperties":true}]},"output":{"oneOf":[{"type":"object","required":["type","model","flagged","categories","category_scores","category_applied_input_types"],"properties":{"type":{"type":"string","const":"moderation_result"},"model":{"type":"string","const":"omni-moderation-latest"},"flagged":{"type":"boolean"},"categories":{"type":"object","additionalProperties":true},"category_scores":{"type":"object","additionalProperties":true},"category_applied_input_types":{"type":"object","additionalProperties":true}},"additionalProperties":true},{"type":"object","required":["type","code","message"],"properties":{"type":{"type":"string","const":"error"},"code":{"type":"string"},"message":{"type":"string"}},"additionalProperties":true}]}},"additionalProperties":true}},"additionalProperties":true}},"text/event-stream":{"schema":{"oneOf":[{"type":"object","required":["type","item_id","output_index","content_index","delta"],"properties":{"type":{"type":"string","const":"response.output_text.delta"},"item_id":{"type":"string"},"output_index":{"type":"integer"},"content_index":{"type":"integer"},"delta":{"type":"string"}},"additionalProperties":true},{"type":"object","required":["type","response"],"properties":{"type":{"type":"string","const":"response.completed"},"response":{"type":"object","properties":{"id":{"type":"string"},"object":{"type":"string","const":"response"},"status":{"type":"string"},"model":{"type":"string"},"output":{"type":"array"},"usage":{"type":"object","properties":{"input_tokens":{"type":"integer"},"output_tokens":{"type":"integer"},"total_tokens":{"type":"integer"}},"additionalProperties":true},"moderation":{"type":"object","properties":{"input":{"oneOf":[{"type":"object","required":["type","model","flagged","categories","category_scores","category_applied_input_types"],"properties":{"type":{"type":"string","const":"moderation_result"},"model":{"type":"string","const":"omni-moderation-latest"},"flagged":{"type":"boolean"},"categories":{"type":"object","additionalProperties":true},"category_scores":{"type":"object","additionalProperties":true},"category_applied_input_types":{"type":"object","additionalProperties":true}},"additionalProperties":true},{"type":"object","required":["type","code","message"],"properties":{"type":{"type":"string","const":"error"},"code":{"type":"string"},"message":{"type":"string"}},"additionalProperties":true}]},"output":{"oneOf":[{"type":"object","required":["type","model","flagged","categories","category_scores","category_applied_input_types"],"properties":{"type":{"type":"string","const":"moderation_result"},"model":{"type":"string","const":"omni-moderation-latest"},"flagged":{"type":"boolean"},"categories":{"type":"object","additionalProperties":true},"category_scores":{"type":"object","additionalProperties":true},"category_applied_input_types":{"type":"object","additionalProperties":true}},"additionalProperties":true},{"type":"object","required":["type","code","message"],"properties":{"type":{"type":"string","const":"error"},"code":{"type":"string"},"message":{"type":"string"}},"additionalProperties":true}]}},"additionalProperties":true}},"additionalProperties":true}},"additionalProperties":true}]}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"type":{"type":"string"},"param":{"type":["string","null"]},"code":{"type":["string","null"]}},"additionalProperties":true}},"additionalProperties":true}}}}}}},"/v1/tools/search":{"post":{"tags":["DeepSeek"],"summary":"DeepSeek Search","operationId":"protocol_operation_deepseek_search","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["query"],"properties":{"query":{"type":"string","minLength":1,"maxLength":128,"description":"Search query of 1–128 Unicode characters; must not consist entirely of whitespace."},"count":{"type":"integer","minimum":1,"maximum":50,"description":"Number of results requested from 1 to 50."},"ori_question":{"type":["string","null"],"minLength":1,"maxLength":128,"description":"Original question of 1–128 Unicode characters. Null is treated as omitted."},"localization":{"type":"string","description":"Localization hint such as the end user's IP address."},"need_content":{"type":"boolean","description":"Request page content in search results."}},"additionalProperties":true,"description":"Synchronous search selected by this path. No model is required and streaming is not supported. Unknown fields are accepted but ignored."}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["results"],"properties":{"results":{"type":"array","description":"Search results. An empty array is a successful response and incurs no charge.","items":{"type":"object","additionalProperties":true}}},"additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"type":{"type":"string"},"param":{"type":["string","null"]},"code":{"type":["string","null"]}},"additionalProperties":true}},"additionalProperties":true}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"type":{"type":"string"},"param":{"type":["string","null"]},"code":{"type":["string","null"]}},"additionalProperties":true}},"additionalProperties":true}}}},"503":{"description":"Unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"type":{"type":"string"},"param":{"type":["string","null"]},"code":{"type":["string","null"]}},"additionalProperties":true}},"additionalProperties":true}}}}}}},"/v1beta/models/{model}{generateContent}":{"post":{"tags":["Gemini"],"summary":"Gemini Generate Content","operationId":"protocol_operation_gemini_generate_content","security":[{"bearerAuth":[]}],"parameters":[{"name":"model","in":"path","required":true,"schema":{"type":"string","description":"RunAPI model identifier placed in the wire path."}},{"name":"generateContent","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["contents"],"properties":{"contents":{"type":"array","description":"Conversation content in Gemini Content and Part format."},"systemInstruction":{"type":"object","description":"System instructions represented as Gemini Content."},"generationConfig":{"type":"object","description":"Gemini generation configuration for the request."},"tools":{"type":"array","description":"Tools the model may call."}},"additionalProperties":true}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"candidates":{"type":"array","items":{"type":"object","properties":{"content":{"type":"object","properties":{"parts":{"type":"array"},"role":{"type":"string"}},"additionalProperties":true},"finishReason":{"type":"string"},"index":{"type":"integer"}},"additionalProperties":true}},"usageMetadata":{"type":"object","properties":{"promptTokenCount":{"type":"integer"},"candidatesTokenCount":{"type":"integer"},"totalTokenCount":{"type":"integer"}},"additionalProperties":true},"modelVersion":{"type":"string"},"responseId":{"type":"string"}},"additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true}},"additionalProperties":true}}}}}}},"/v1beta/models/{model}{streamGenerateContent}?alt=sse":{"post":{"tags":["Gemini"],"summary":"Gemini Stream Generate Content","operationId":"protocol_operation_gemini_stream_generate_content","security":[{"bearerAuth":[]}],"parameters":[{"name":"model","in":"path","required":true,"schema":{"type":"string","description":"RunAPI model identifier placed in the wire path."}},{"name":"streamGenerateContent","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["contents"],"properties":{"contents":{"type":"array","description":"Conversation content in Gemini Content and Part format."},"systemInstruction":{"type":"object","description":"System instructions represented as Gemini Content."},"generationConfig":{"type":"object","description":"Gemini generation configuration for the request."},"tools":{"type":"array","description":"Tools the model may call."}},"additionalProperties":true}}}},"responses":{"200":{"description":"Streaming","content":{"text/event-stream":{"schema":{"type":"object","properties":{"candidates":{"type":"array","items":{"type":"object","properties":{"content":{"type":"object","properties":{"parts":{"type":"array"},"role":{"type":"string"}},"additionalProperties":true},"finishReason":{"type":"string"},"index":{"type":"integer"}},"additionalProperties":true}},"usageMetadata":{"type":"object","properties":{"promptTokenCount":{"type":"integer"},"candidatesTokenCount":{"type":"integer"},"totalTokenCount":{"type":"integer"}},"additionalProperties":true},"modelVersion":{"type":"string"},"responseId":{"type":"string"}},"additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true}},"additionalProperties":true}}}}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API token"}}}}