{"openapi":"3.1.0","info":{"title":"FAE Generative API","version":"1.1.5","description":"Workspace-scoped chat, characters, image generation, Kokoro speech, saved voices, and Chatterbox voice cloning on the FAE provider network."},"servers":[{"url":"https://www.faeframeworks.com","description":"Production"}],"tags":[{"name":"Documentation","description":"Machine-readable and downloadable API guidance for AI agents and developers."},{"name":"Service","description":"Network health and capability discovery."},{"name":"Chat","description":"OpenAI-compatible non-streaming chat completions."},{"name":"Characters","description":"Workspace-isolated character profiles and metered in-character responses."},{"name":"Images","description":"Fooocus text-to-image and image-to-image jobs."},{"name":"Speech","description":"Kokoro text-to-speech with built-in voices."},{"name":"Voices","description":"Reusable Chatterbox reference voices."},{"name":"Voice generations","description":"Generate and retrieve cloned speech."}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"Workspace API key. xi-api-key is also accepted."}},"schemas":{"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","examples":["invalid_prompt"]},"message":{"type":"string"}}}}},"Model":{"type":"object","required":["id","object","capability","ready_nodes"],"properties":{"id":{"type":"string"},"object":{"const":"model"},"capability":{"type":"string","enum":["chat","image","speech","voice-cloning"]},"ready_nodes":{"type":"integer","minimum":0}}},"ChatMessage":{"type":"object","required":["role","content"],"properties":{"role":{"type":"string","enum":["system","user","assistant"]},"content":{"type":"string","minLength":1}}},"ChatCompletionRequest":{"type":"object","required":["messages"],"properties":{"model":{"type":"string","default":"fae-text"},"messages":{"type":"array","minItems":1,"maxItems":50,"items":{"$ref":"#/components/schemas/ChatMessage"}},"max_tokens":{"type":"integer","minimum":1,"maximum":4096,"default":512},"stream":{"const":false,"default":false}}},"ChatCompletion":{"type":"object","required":["id","object","created","model","choices"],"properties":{"id":{"type":"string"},"object":{"const":"chat.completion"},"created":{"type":"integer"},"model":{"type":"string"},"choices":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer"},"message":{"$ref":"#/components/schemas/ChatMessage"},"finish_reason":{"type":"string"}}}},"usage":{"type":"object","properties":{"prompt_tokens":{"type":"integer"},"completion_tokens":{"type":"integer"},"total_tokens":{"type":"integer"},"credits_charged":{"type":"number"}}}}},"SpeechRequest":{"type":"object","required":["input"],"properties":{"model":{"type":"string","default":"kokoro"},"input":{"type":"string","minLength":1,"maxLength":2000},"voice":{"type":"string","default":"af_heart"},"speed":{"type":"number","minimum":0.5,"maximum":2,"default":1},"response_format":{"const":"wav","default":"wav"}}},"Lora":{"type":"object","required":["name"],"properties":{"name":{"type":"string"},"weight":{"type":"number","minimum":0,"maximum":2,"default":0.8}}},"ImageGenerationRequest":{"type":"object","required":["prompt"],"properties":{"prompt":{"type":"string","minLength":1,"maxLength":4000},"negative_prompt":{"type":"string","maxLength":4000},"model":{"type":"string","default":"fooocus"},"n":{"type":"integer","minimum":1,"maximum":4,"default":1},"size":{"type":"string","pattern":"^\\d{3,4}x\\d{3,4}$","default":"1024x1024","examples":["1024x1024","1344x768"]},"width":{"type":"integer","minimum":512,"maximum":1536,"multipleOf":64},"height":{"type":"integer","minimum":512,"maximum":1536,"multipleOf":64},"output_format":{"type":"string","enum":["png","jpeg","webp"],"default":"webp"},"response_format":{"type":"string","enum":["url","b64_json"],"default":"url"},"performance":{"type":"string","enum":["Lightning","Speed","Quality"],"default":"Speed"},"styles":{"type":"array","maxItems":5,"items":{"type":"string"},"default":["Fooocus V2"]},"seed":{"type":"integer","minimum":-1,"maximum":2147483647,"default":-1},"cfg_scale":{"type":"number","minimum":1,"maximum":30,"default":7},"sharpness":{"type":"number","minimum":0,"maximum":30,"default":2},"steps":{"type":"integer","minimum":-1,"maximum":100,"default":-1},"enhance_prompt":{"type":"boolean","default":true},"loras":{"type":"array","maxItems":5,"items":{"$ref":"#/components/schemas/Lora"}},"input_image":{"type":"string","description":"PNG, JPEG, or WebP data URL up to 10 MB for image-to-image generation."},"vary_method":{"type":"string","enum":["Vary (Subtle)","Vary (Strong)"],"default":"Vary (Strong)"},"wait":{"type":"boolean","default":false,"description":"Wait for completion instead of immediately returning the queued job."},"wait_timeout":{"type":"integer","minimum":1,"maximum":300,"default":120}}},"ImageData":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"download_url":{"type":"string","format":"uri"},"b64_json":{"type":"string"}}},"ImageGeneration":{"type":"object","required":["id","object","created","status","prompt","data"],"properties":{"id":{"type":"string"},"object":{"const":"image.generation"},"created":{"type":"integer"},"completed_at":{"type":["string","null"],"format":"date-time"},"status":{"type":"string","enum":["queued","processing","completed","failed"]},"model":{"type":"string"},"prompt":{"type":"string"},"negative_prompt":{"type":"string"},"size":{"type":"string"},"n":{"type":"integer"},"output_format":{"type":"string"},"response_format":{"type":"string"},"seed":{"type":"integer"},"error":{"type":["string","null"]},"data":{"type":"array","items":{"$ref":"#/components/schemas/ImageData"}},"data_included":{"type":"boolean","description":"False in list responses when base64 result data is intentionally omitted."},"credits_charged":{"type":"number"},"billing_status":{"type":"string","enum":["unmetered","reserved","settled","refunded"]},"status_url":{"type":"string","format":"uri"}}},"Character":{"type":"object","required":["_id","workspace","name"],"properties":{"_id":{"type":"string"},"workspace":{"type":"string"},"name":{"type":"string","maxLength":100},"traits":{"type":"array","maxItems":50,"items":{"type":"string","maxLength":200}},"catchphrases":{"type":"array","maxItems":50,"items":{"type":"string","maxLength":500}},"favorite_topics":{"type":"array","maxItems":50,"items":{"type":"string","maxLength":200}},"background":{"type":"string","maxLength":10000},"visibility":{"type":"string","enum":["private","public"]},"friends":{"type":"array","maxItems":50,"items":{"type":"string","maxLength":200}},"enemies":{"type":"array","maxItems":50,"items":{"type":"string","maxLength":200}},"avatar":{"type":"string","maxLength":2048},"ollamaModel":{"type":"string","maxLength":120},"prompt":{"type":"string","maxLength":10000},"systemInstructions":{"type":"string","maxLength":10000},"contextMemory":{"type":"array","maxItems":100,"items":{"type":"string","maxLength":1000},"description":"Returned only by the single-character endpoint, not list responses."},"custom":{"type":"object"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}}},"CharacterResponseRequest":{"type":"object","required":["text"],"properties":{"text":{"type":"string","minLength":1,"maxLength":8000},"model":{"type":"string","maxLength":120},"max_tokens":{"type":"integer","minimum":1,"maximum":4096,"default":512}}},"CharacterResponse":{"type":"object","required":["response","character_id","model","usage"],"properties":{"response":{"type":"string"},"character_id":{"type":"string"},"model":{"type":"string"},"usage":{"type":"object","properties":{"prompt_tokens":{"type":"integer"},"completion_tokens":{"type":"integer"},"total_tokens":{"type":"integer"},"credits_charged":{"type":"number"}}}}},"VoiceSettings":{"type":"object","properties":{"exaggeration":{"type":"number","minimum":0,"maximum":1,"default":0.5},"cfg_weight":{"type":"number","minimum":0,"maximum":1,"default":0.5},"turbo":{"type":"boolean","default":false}}},"Voice":{"type":"object","required":["voice_id","name"],"properties":{"voice_id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"labels":{"type":"object","additionalProperties":{"type":"string"}},"reference_filename":{"type":"string"},"reference_bytes":{"type":"integer"},"settings":{"$ref":"#/components/schemas/VoiceSettings"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}}},"VoiceGeneration":{"type":"object","properties":{"generation_id":{"type":"string"},"voice_id":{"type":["string","null"]},"text":{"type":"string"},"status":{"type":"string","enum":["processing","completed","failed"]},"output_format":{"const":"wav"},"audio_url":{"type":["string","null"]},"error":{"type":["string","null"]},"credits_charged":{"type":"number"},"billing_status":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"completed_at":{"type":["string","null"],"format":"date-time"}}}}},"paths":{"/v1/llms.txt":{"get":{"tags":["Documentation"],"operationId":"getAiGuide","summary":"Read the AI agent guide as Markdown text","responses":{"200":{"description":"AI agent guide","content":{"text/markdown":{"schema":{"type":"string"}}}}}}},"/v1/guide.md":{"get":{"tags":["Documentation"],"operationId":"downloadAiGuideMarkdown","summary":"Download the AI agent guide as Markdown","responses":{"200":{"description":"Markdown guide attachment","content":{"text/markdown":{"schema":{"type":"string"}}}}}}},"/v1":{"get":{"tags":["Service"],"operationId":"getApiInfo","summary":"API information","responses":{"200":{"description":"API links"}}}},"/v1/status":{"get":{"tags":["Service"],"operationId":"getNetworkStatus","summary":"All provider-network capabilities","responses":{"200":{"description":"Readiness by service"}}}},"/v1/models":{"get":{"tags":["Service"],"operationId":"listModels","summary":"List API capabilities and ready nodes","responses":{"200":{"description":"Model list","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Model"}}}}}}}}}},"/v1/pricing":{"get":{"tags":["Service"],"operationId":"getApiPricing","summary":"Get live generative API credit rates","responses":{"200":{"description":"Credit pricing"}}}},"/v1/credits":{"get":{"tags":["Service"],"operationId":"getCreditBalance","summary":"Get workspace credit balance","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Credit balance"},"401":{"description":"Invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/credits/usage":{"get":{"tags":["Service"],"operationId":"listCreditUsage","summary":"List workspace API credit charges and refunds","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Credit usage history"},"401":{"description":"Invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/chat/completions":{"post":{"tags":["Chat"],"operationId":"createChatCompletion","summary":"Create a chat completion","security":[{"ApiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatCompletionRequest"}}}},"responses":{"200":{"description":"Completion","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatCompletion"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Insufficient credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"No text provider ready","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Generation timed out","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/audio/voices":{"get":{"tags":["Speech"],"operationId":"listSpeechVoices","summary":"List Kokoro voices and availability","responses":{"200":{"description":"Voice list"}}}},"/v1/audio/speech":{"post":{"tags":["Speech"],"operationId":"createSpeech","summary":"Generate Kokoro WAV speech","security":[{"ApiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SpeechRequest"}}}},"responses":{"200":{"description":"Generated WAV","content":{"audio/wav":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Insufficient credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"No Kokoro provider ready","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Generation timed out","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/images/status":{"get":{"tags":["Images"],"operationId":"getImageStatus","summary":"Get Fooocus network availability","responses":{"200":{"description":"Image availability"}}}},"/v1/images/generations":{"post":{"tags":["Images"],"operationId":"createImageGeneration","summary":"Create a text-to-image or image-to-image job","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","maxLength":200}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImageGenerationRequest"}}}},"responses":{"200":{"description":"Completed generation when wait=true","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImageGeneration"}}}},"202":{"description":"Queued or processing generation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImageGeneration"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Insufficient credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Generation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"get":{"tags":["Images"],"operationId":"listImageGenerations","summary":"List image generation history","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"name":"skip","in":"query","schema":{"type":"integer","minimum":0,"default":0}}],"responses":{"200":{"description":"Generation list"},"401":{"description":"Invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/images/generations/{generation_id}":{"parameters":[{"name":"generation_id","in":"path","required":true,"description":"Image generation ID","schema":{"type":"string"}}],"get":{"tags":["Images"],"operationId":"getImageGeneration","summary":"Get image generation status and results","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Generation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImageGeneration"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"tags":["Images"],"operationId":"deleteImageGeneration","summary":"Delete generation metadata and stored images","security":[{"ApiKeyAuth":[]}],"responses":{"204":{"description":"Deleted"},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Generation is processing","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/images/generations/{generation_id}/content/{index}":{"get":{"tags":["Images"],"operationId":"downloadGeneratedImage","summary":"Download a generated image through the authenticated proxy","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"generation_id","in":"path","required":true,"description":"Image generation ID","schema":{"type":"string"}},{"name":"index","in":"path","required":true,"schema":{"type":"integer","minimum":0}}],"responses":{"200":{"description":"Image bytes","content":{"image/png":{},"image/jpeg":{},"image/webp":{}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Still processing","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/characters":{"get":{"tags":["Characters"],"operationId":"listCharacters","summary":"List characters in the API key workspace","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":100}},{"name":"skip","in":"query","schema":{"type":"integer","minimum":0,"maximum":10000,"default":0}}],"responses":{"200":{"description":"Characters","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Character"}}}}},"401":{"description":"Invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"tags":["Characters"],"operationId":"createCharacter","summary":"Create a character in the API key workspace","security":[{"ApiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["name"],"properties":{"name":{"type":"string","minLength":1,"maxLength":100}},"additionalProperties":true}}}},"responses":{"201":{"description":"Character created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Character"}}}},"400":{"description":"Invalid character","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/characters/{character_id}":{"parameters":[{"name":"character_id","in":"path","required":true,"description":"Character ID","schema":{"type":"string"}}],"get":{"tags":["Characters"],"operationId":"getCharacter","summary":"Get a workspace character","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Character","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Character"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"tags":["Characters"],"operationId":"updateCharacter","summary":"Update supported character fields","security":[{"ApiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","minProperties":1,"additionalProperties":true}}}},"responses":{"200":{"description":"Updated character","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Character"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"tags":["Characters"],"operationId":"deleteCharacter","summary":"Delete a workspace character","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Deleted"},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/characters/{character_id}/responses":{"post":{"tags":["Characters"],"operationId":"createCharacterResponse","summary":"Generate a metered in-character response","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"character_id","in":"path","required":true,"description":"Character ID","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CharacterResponseRequest"}}}},"responses":{"200":{"description":"Character response","headers":{"X-Credits-Charged":{"schema":{"type":"number"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CharacterResponse"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Insufficient credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Character not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"No text provider ready","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Generation timed out","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/voices":{"get":{"tags":["Voices"],"operationId":"listVoices","summary":"List saved voices","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Voice list","content":{"application/json":{"schema":{"type":"object","properties":{"voices":{"type":"array","items":{"$ref":"#/components/schemas/Voice"}}}}}}}}},"post":{"tags":["Voices"],"operationId":"createVoice","summary":"Create a saved voice","security":[{"ApiKeyAuth":[]}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","required":["name","audio"],"properties":{"name":{"type":"string","maxLength":100},"audio":{"type":"string","format":"binary"},"description":{"type":"string","maxLength":500},"labels":{"type":"string","description":"JSON object"},"exaggeration":{"type":"number"},"cfg_weight":{"type":"number"},"turbo":{"type":"boolean"}}}}}},"responses":{"201":{"description":"Voice created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Voice"}}}},"413":{"description":"Audio too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Unsupported audio type","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/voices/{voice_id}":{"parameters":[{"name":"voice_id","in":"path","required":true,"description":"Saved voice ID","schema":{"type":"string"}}],"get":{"tags":["Voices"],"operationId":"getVoice","summary":"Get a saved voice","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Voice","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Voice"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"tags":["Voices"],"operationId":"deleteVoice","summary":"Delete a saved voice","security":[{"ApiKeyAuth":[]}],"responses":{"204":{"description":"Deleted"},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/text-to-speech/{voice_id}":{"post":{"tags":["Voice generations"],"operationId":"generateClonedSpeech","summary":"Generate cloned WAV speech","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"voice_id","in":"path","required":true,"description":"Saved voice ID","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["text"],"properties":{"text":{"type":"string","maxLength":2000},"output_format":{"const":"wav"},"voice_settings":{"$ref":"#/components/schemas/VoiceSettings"}}}}}},"responses":{"200":{"description":"Generated WAV","content":{"audio/wav":{"schema":{"type":"string","format":"binary"}}}},"402":{"description":"Insufficient credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"No Chatterbox provider ready","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/generations":{"get":{"tags":["Voice generations"],"operationId":"listVoiceGenerations","summary":"List voice generation history","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Generation list"}}}},"/v1/generations/{generation_id}":{"get":{"tags":["Voice generations"],"operationId":"getVoiceGeneration","summary":"Get voice generation metadata","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"generation_id","in":"path","required":true,"description":"Voice generation ID","schema":{"type":"string"}}],"responses":{"200":{"description":"Generation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VoiceGeneration"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/generations/{generation_id}/audio":{"get":{"tags":["Voice generations"],"operationId":"downloadGeneratedSpeech","summary":"Download generated WAV","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"generation_id","in":"path","required":true,"description":"Voice generation ID","schema":{"type":"string"}}],"responses":{"200":{"description":"WAV","content":{"audio/wav":{"schema":{"type":"string","format":"binary"}}}},"409":{"description":"Still processing","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}