[{"id":"search","payments":{"credits":{"method":"POST","path":"/api/v1/search","auth":"bearer","requires_conversation":false,"input_schema":{"$defs":{"SearchProvider":{"enum":["auto","anthropic","z-ai","gemini","exa"],"title":"SearchProvider","type":"string"}},"description":"Web search request.","properties":{"query":{"description":"Search query","title":"Query","type":"string"},"provider":{"$ref":"#/$defs/SearchProvider","default":"auto","description":"Search provider: auto (default), anthropic, z-ai, gemini, exa"},"max_results":{"default":10,"description":"Maximum number of results","maximum":50,"minimum":1,"title":"Max Results","type":"integer"},"allowed_domains":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"Only include these domains (Anthropic only)","title":"Allowed Domains"},"blocked_domains":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"Exclude these domains (Anthropic only)","title":"Blocked Domains"},"recency_filter":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Recency filter: oneDay, oneWeek, oneMonth, oneYear (Z.AI only)","title":"Recency Filter"},"domain_filter":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Restrict to domain, e.g. arxiv.org (Z.AI only)","title":"Domain Filter"},"context":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Previous conversation context for follow-up queries (Gemini only)","title":"Context"}},"required":["query"],"title":"SearchRequest","type":"object"},"constraints":[]},"x402":{"method":"POST","path":"/api/v1/x402/search","auth":"x402","requires_conversation":false,"input_schema":{"$defs":{"SearchProvider":{"enum":["auto","anthropic","z-ai","gemini","exa"],"title":"SearchProvider","type":"string"}},"description":"Web search request.","properties":{"query":{"description":"Search query","title":"Query","type":"string"},"provider":{"$ref":"#/$defs/SearchProvider","default":"auto","description":"Search provider: auto (default), anthropic, z-ai, gemini, exa"},"max_results":{"default":10,"description":"Maximum number of results","maximum":50,"minimum":1,"title":"Max Results","type":"integer"},"allowed_domains":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"Only include these domains (Anthropic only)","title":"Allowed Domains"},"blocked_domains":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"Exclude these domains (Anthropic only)","title":"Blocked Domains"},"recency_filter":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Recency filter: oneDay, oneWeek, oneMonth, oneYear (Z.AI only)","title":"Recency Filter"},"domain_filter":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Restrict to domain, e.g. arxiv.org (Z.AI only)","title":"Domain Filter"},"context":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Previous conversation context for follow-up queries (Gemini only)","title":"Context"}},"required":["query"],"title":"SearchRequest","type":"object"},"constraints":[]}},"example":{"query":"Cue OS","max_results":3},"models_path":null,"quote_path":"/api/v1/services/search/quote","recovery":null},{"id":"image.generate","payments":{"credits":{"method":"POST","path":"/api/v1/image/generate","auth":"bearer","requires_conversation":false,"input_schema":{"additionalProperties":false,"properties":{"prompt":{"maxLength":2000,"minLength":1,"title":"Prompt","type":"string"},"conversation_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Conversation ID for cost tracking and iteration context","title":"Conversation Id"},"use_conversation_context":{"default":true,"description":"When false, prior conversation messages are excluded from the generation request, so earlier images cannot bleed into the new prompt. The conversation is still used for credit tracking and message persistence.","title":"Use Conversation Context","type":"boolean"},"title":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Optional title for the image","title":"Title"},"model":{"default":"gemini-3.1-flash-lite-image","description":"Image model ID from GET /image/models. The model selects the internal provider.","title":"Model","type":"string"},"persist":{"default":"temp","description":"Storage mode: 'none' (base64 only for synchronous providers), 'temp' (S3, 7-day expiry), 'library' (permanent S3 object and library post). Queued Cue Image jobs treat 'none' as 'temp' so the finished image remains retrievable.","enum":["none","temp","library"],"title":"Persist","type":"string"},"aspect_ratio":{"anyOf":[{"enum":["1:1","2:3","3:2","3:4","4:3","4:5","5:4","9:16","16:9","21:9","1:2","2:1","19.5:9","9:19.5","20:9","9:20","auto","square","portrait","landscape"],"type":"string"},{"type":"null"}],"default":null,"description":"Output aspect ratio when supported. Aliases: square, portrait, landscape.","title":"Aspect Ratio"},"resolution":{"anyOf":[{"enum":["1K","2K","4K"],"type":"string"},{"type":"null"}],"default":null,"description":"[Gemini/xAI] Image resolution. Gemini supports 1K/2K/4K; xAI supports 1K/2K.","title":"Resolution"},"size":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Output size accepted by the selected model, such as 512x512, 2K, 4K, or auto.","title":"Size"},"quality":{"anyOf":[{"enum":["low","medium","high","auto"],"type":"string"},{"type":"null"}],"default":null,"description":"Quality: OpenAI low/medium/high/auto; xAI Image 2.0 low/medium.","title":"Quality"},"output_format":{"anyOf":[{"enum":["jpeg","png","webp"],"type":"string"},{"type":"null"}],"default":null,"description":"[OpenAI] Output format: jpeg, png, webp. Default: png","title":"Output Format"},"output_compression":{"anyOf":[{"maximum":100,"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"[OpenAI] Compression level 0-100. Only for jpeg/webp.","title":"Output Compression"},"background":{"anyOf":[{"enum":["auto","opaque","transparent"],"type":"string"},{"type":"null"}],"default":null,"description":"[OpenAI] Background: auto, opaque, or transparent. Only for png/webp. gpt-image-2 does not support transparent backgrounds.","title":"Background"}},"required":["prompt"],"title":"ImageGenerateRequest","type":"object"},"constraints":[]},"x402":{"method":"POST","path":"/api/v1/x402/image/generate","auth":"x402","requires_conversation":false,"input_schema":{"additionalProperties":false,"description":"Image generation with model-aware x402 pricing.","properties":{"prompt":{"maxLength":2000,"minLength":1,"title":"Prompt","type":"string"},"use_conversation_context":{"default":true,"description":"When false, prior conversation messages are excluded from the generation request, so earlier images cannot bleed into the new prompt. The conversation is still used for credit tracking and message persistence.","title":"Use Conversation Context","type":"boolean"},"title":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Optional title for the image","title":"Title"},"model":{"default":"grok-imagine-image","description":"Image model; the x402 quote uses its configured rendering price.","title":"Model","type":"string"},"aspect_ratio":{"anyOf":[{"enum":["1:1","2:3","3:2","3:4","4:3","4:5","5:4","9:16","16:9","21:9","1:2","2:1","19.5:9","9:19.5","20:9","9:20","auto","square","portrait","landscape"],"type":"string"},{"type":"null"}],"default":null,"description":"Output aspect ratio when supported. Aliases: square, portrait, landscape.","title":"Aspect Ratio"},"resolution":{"anyOf":[{"enum":["1K","2K","4K"],"type":"string"},{"type":"null"}],"default":null,"description":"[Gemini/xAI] Image resolution. Gemini supports 1K/2K/4K; xAI supports 1K/2K.","title":"Resolution"},"size":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Output size accepted by the selected model, such as 512x512, 2K, 4K, or auto.","title":"Size"},"quality":{"anyOf":[{"enum":["low","medium","high","auto"],"type":"string"},{"type":"null"}],"default":null,"description":"Quality: OpenAI low/medium/high/auto; xAI Image 2.0 low/medium.","title":"Quality"},"output_format":{"anyOf":[{"enum":["jpeg","png","webp"],"type":"string"},{"type":"null"}],"default":null,"description":"[OpenAI] Output format: jpeg, png, webp. Default: png","title":"Output Format"},"output_compression":{"anyOf":[{"maximum":100,"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"[OpenAI] Compression level 0-100. Only for jpeg/webp.","title":"Output Compression"},"background":{"anyOf":[{"enum":["auto","opaque","transparent"],"type":"string"},{"type":"null"}],"default":null,"description":"[OpenAI] Background: auto, opaque, or transparent. Only for png/webp. gpt-image-2 does not support transparent backgrounds.","title":"Background"}},"required":["prompt"],"title":"X402ImageGenerateRequest","type":"object"},"constraints":[]}},"example":{"prompt":"A blue ceramic mug on a white table","model":"cue-image-1","size":"512x512"},"models_path":"/api/v1/services/image.generate/models","quote_path":"/api/v1/services/image.generate/quote","recovery":{"request_header":"Idempotency-Key","recommended_request_id_format":"uuid","retention_seconds":604800,"status_path":"/api/v1/services/requests/{request_id}","x402_auth":"original Payment-Signature and recovery secret","recovery_token_header":"X-Cue-Recovery-Token","credits_auth":"bearer"}},{"id":"image.edit","payments":{"credits":{"method":"POST","path":"/api/v1/image/edits","auth":"bearer","requires_conversation":false,"input_schema":{"$defs":{"ImageEditInput":{"additionalProperties":false,"properties":{"image_base64":{"maxLength":6990508,"minLength":1,"title":"Image Base64","type":"string"},"mime_type":{"enum":["image/png","image/jpeg","image/webp"],"title":"Mime Type","type":"string"}},"required":["image_base64","mime_type"],"title":"ImageEditInput","type":"object"}},"additionalProperties":false,"properties":{"prompt":{"maxLength":2000,"minLength":1,"title":"Prompt","type":"string"},"model":{"default":"cue-image-edit-1","enum":["cue-image-edit-1"],"title":"Model","type":"string"},"images":{"items":{"$ref":"#/$defs/ImageEditInput"},"maxItems":3,"minItems":1,"title":"Images","type":"array"}},"required":["prompt","images"],"title":"ImageEditRequest","type":"object"},"constraints":[]},"x402":{"method":"POST","path":"/api/v1/x402/image/edits","auth":"x402","requires_conversation":false,"input_schema":{"$defs":{"ImageEditInput":{"additionalProperties":false,"properties":{"image_base64":{"maxLength":6990508,"minLength":1,"title":"Image Base64","type":"string"},"mime_type":{"enum":["image/png","image/jpeg","image/webp"],"title":"Mime Type","type":"string"}},"required":["image_base64","mime_type"],"title":"ImageEditInput","type":"object"}},"additionalProperties":false,"properties":{"prompt":{"maxLength":2000,"minLength":1,"title":"Prompt","type":"string"},"model":{"default":"cue-image-edit-1","enum":["cue-image-edit-1"],"title":"Model","type":"string"},"images":{"items":{"$ref":"#/$defs/ImageEditInput"},"maxItems":3,"minItems":1,"title":"Images","type":"array"}},"required":["prompt","images"],"title":"ImageEditRequest","type":"object"},"constraints":["One to three inline PNG, JPEG, or WebP files; no animated images or remote URLs.","At most 5 MiB per file, 10 MiB combined, and 16 million pixels per image.","The first image determines output dimensions; size and aspect overrides are unsupported.","Async result: save the request ID and recovery secret before paying; retain the result within seven days."]}},"example":{"prompt":"Make the object blue","model":"cue-image-edit-1","images":[{"image_base64":"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAIAAACQd1PeAAAADElEQVR4nGP4//8/AAX+Av4N70a4AAAAAElFTkSuQmCC","mime_type":"image/png"}]},"models_path":"/api/v1/services/image.edit/models","quote_path":"/api/v1/services/image.edit/quote","recovery":{"request_header":"Idempotency-Key","recommended_request_id_format":"uuid","retention_seconds":604800,"status_path":"/api/v1/services/requests/{request_id}","x402_auth":"original Payment-Signature and recovery secret","recovery_token_header":"X-Cue-Recovery-Token","credits_auth":"bearer"}},{"id":"transcribe","payments":{"credits":{"method":"POST","path":"/api/v1/transcribe","auth":"bearer","requires_conversation":false,"input_schema":{"$defs":{"TranscribeProvider":{"enum":["gemini","z-ai","openai","xai"],"title":"TranscribeProvider","type":"string"}},"description":"Request to transcribe audio.","properties":{"audio_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"URL to audio file (S3, YouTube, etc.)","title":"Audio Url"},"audio_base64":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Base64-encoded audio data (max ~20MB)","title":"Audio Base64"},"mime_type":{"default":"audio/wav","description":"Audio MIME type (audio/wav, audio/mp3, etc.)","title":"Mime Type","type":"string"},"provider":{"$ref":"#/$defs/TranscribeProvider","default":"gemini","description":"Transcription provider: gemini (default), openai, z-ai, or xai"},"prompt":{"anyOf":[{"maxLength":8000,"type":"string"},{"type":"null"}],"default":null,"description":"Custom prompt / context (Gemini: up to 2000, Z.AI: up to 8000 chars)","title":"Prompt"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Model: flash/pro (Gemini), whisper-1/gpt-4o-transcribe/gpt-4o-mini-transcribe (OpenAI). xAI currently exposes one STT model and ignores this field.","title":"Model"},"include_timestamps":{"default":false,"description":"Include MM:SS timestamps (Gemini only)","title":"Include Timestamps","type":"boolean"},"include_speakers":{"default":false,"description":"Identify different speakers (Gemini only)","title":"Include Speakers","type":"boolean"},"translate_to":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Target language for translation (Gemini only)","title":"Translate To"},"hotwords":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"Keywords for better recognition (Z.AI only, max 100)","title":"Hotwords"},"language":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Language code, e.g. 'en' (OpenAI or xAI)","title":"Language"},"text_format":{"default":false,"description":"xAI inverse text normalization for numbers, currencies, and units; requires language","title":"Text Format","type":"boolean"},"multichannel":{"default":false,"description":"xAI per-channel transcription","title":"Multichannel","type":"boolean"},"channels":{"anyOf":[{"maximum":8,"minimum":2,"type":"integer"},{"type":"null"}],"default":null,"description":"xAI channel count for raw multichannel audio","title":"Channels"},"diarize":{"default":false,"description":"xAI speaker diarization","title":"Diarize","type":"boolean"},"filler_words":{"default":false,"description":"Preserve filler words in xAI transcripts","title":"Filler Words","type":"boolean"},"vad_threshold":{"anyOf":[{"maximum":1,"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"xAI voice-activity threshold","title":"Vad Threshold"},"audio_format":{"anyOf":[{"enum":["pcm","mulaw","alaw"],"type":"string"},{"type":"null"}],"default":null,"description":"xAI format hint for raw/headerless audio","title":"Audio Format"},"sample_rate":{"anyOf":[{"enum":[8000,16000,22050,24000,44100,48000],"type":"integer"},{"type":"null"}],"default":null,"description":"xAI sample rate for raw/headerless audio","title":"Sample Rate"},"conversation_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Conversation ID for cost tracking","title":"Conversation Id"}},"title":"TranscribeRequest","type":"object","anyOf":[{"required":["audio_url"],"properties":{"audio_url":{"type":"string","minLength":1}}},{"required":["audio_base64"],"properties":{"audio_base64":{"type":"string","minLength":1}}}],"allOf":[{"if":{"required":["provider"],"properties":{"provider":{"enum":["openai","z-ai"]}}},"then":{"required":["audio_base64"],"properties":{"audio_base64":{"type":"string","minLength":1}}}}]},"constraints":[]},"x402":{"method":"POST","path":"/api/v1/x402/transcribe","auth":"x402","requires_conversation":false,"input_schema":{"$defs":{"TranscribeProvider":{"enum":["gemini","z-ai","openai","xai"],"title":"TranscribeProvider","type":"string"}},"description":"Request to transcribe audio.","properties":{"audio_url":{"type":"null"},"audio_base64":{"type":"string","minLength":1,"maxLength":27962028,"description":"Audio file as base64; at most 20 MB and 60 decoded seconds"},"mime_type":{"default":"audio/wav","description":"Audio MIME type (audio/wav, audio/mp3, etc.)","title":"Mime Type","type":"string"},"provider":{"$ref":"#/$defs/TranscribeProvider","default":"gemini","description":"Transcription provider: gemini (default), openai, z-ai, or xai"},"prompt":{"type":"null"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Model: flash/pro (Gemini), whisper-1/gpt-4o-transcribe/gpt-4o-mini-transcribe (OpenAI). xAI currently exposes one STT model and ignores this field.","title":"Model"},"include_timestamps":{"default":false,"description":"Include MM:SS timestamps (Gemini only)","title":"Include Timestamps","type":"boolean"},"include_speakers":{"const":false},"translate_to":{"type":"null"},"hotwords":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"Keywords for better recognition (Z.AI only, max 100)","title":"Hotwords"},"language":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Language code, e.g. 'en' (OpenAI or xAI)","title":"Language"},"text_format":{"default":false,"description":"xAI inverse text normalization for numbers, currencies, and units; requires language","title":"Text Format","type":"boolean"},"multichannel":{"const":false},"channels":{"type":"null"},"diarize":{"const":false},"filler_words":{"default":false,"description":"Preserve filler words in xAI transcripts","title":"Filler Words","type":"boolean"},"vad_threshold":{"anyOf":[{"maximum":1,"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"xAI voice-activity threshold","title":"Vad Threshold"},"audio_format":{"type":"null"},"sample_rate":{"type":"null"}},"title":"TranscribeRequest","type":"object","allOf":[{"if":{"required":["provider"],"properties":{"provider":{"enum":["openai","z-ai"]}}},"then":{"required":["audio_base64"],"properties":{"audio_base64":{"type":"string","minLength":1}}}}],"required":["audio_base64"]},"constraints":["Upload audio_base64: at most 20 MB and 60 decoded seconds. WAV, MP3, FLAC, OGG, and other decodable audio files.","The server measures and normalizes the audio before payment; URL and raw/headerless inputs require credits.","One audio stream, normalized to mono. Multichannel/diarization and custom prompts require credits."]}},"example":{"audio_base64":"UklGRkQAAABXQVZFZm10IBAAAAABAAEAgD4AAAB9AAACABAAZGF0YSAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA==","mime_type":"audio/wav"},"models_path":null,"quote_path":"/api/v1/services/transcribe/quote","recovery":null},{"id":"speech.generate","payments":{"credits":{"method":"POST","path":"/api/v1/tts/generate","auth":"bearer","requires_conversation":false,"input_schema":{"$defs":{"TTSProvider":{"enum":["gemini","z-ai","elevenlabs","openai","xai","dashscope","qwen-audio","minimax"],"title":"TTSProvider","type":"string"}},"description":"Request to generate speech from text.","properties":{"text":{"description":"Text to convert to speech","maxLength":20000,"minLength":1,"title":"Text","type":"string"},"provider":{"$ref":"#/$defs/TTSProvider","default":"gemini","description":"TTS provider: gemini (default), z-ai, elevenlabs, openai, xai, dashscope, qwen-audio, or minimax"},"voice":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Voice name. Gemini: Kore (default), Aoede, Puck, Charon, etc. Z.AI: tongtong (default), chuichui, xiaochen, jam, kazi, douji, luodo. ElevenLabs: jessica (default), hope, ryan, or a voice ID. OpenAI: coral (default), alloy, ash, ballad, echo, fable, nova, onyx, sage, shimmer, verse, marin, cedar. xAI: eve (default), ara, rex, sal, or another xAI voice ID. DashScope: Cherry (default), another system voice, or an owned designed/cloned voice ID. MiniMax: English_Graceful_Lady (default), another system voice ID, or a cloned/designed voice ID.","title":"Voice"},"style":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"description":"Style prompt (Gemini only)","title":"Style"},"instructions":{"anyOf":[{"maxLength":2000,"type":"string"},{"type":"null"}],"default":null,"description":"Speech instructions for OpenAI or a DashScope instruct model","title":"Instructions"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Model: 'flash'/'pro' (Gemini), 'eleven_v3' (ElevenLabs), 'gpt-4o-mini-tts'/'tts-1'/'tts-1-hd' (OpenAI), or a supported Speech 2.8/2.6 model ID (MiniMax)","title":"Model"},"response_format":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Output format: mp3, opus, aac, flac, wav, pcm (provider support varies)","title":"Response Format"},"speed":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Speech speed (Z.AI and MiniMax: 0.5-2.0, xAI: 0.7-1.5, ElevenLabs: configurable, OpenAI tts-1: 0.25-4.0)","title":"Speed"},"volume":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Volume 0-10 (Z.AI or MiniMax)","title":"Volume"},"language_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"DashScope language: Auto, Chinese, English, German, Italian, Portuguese, Spanish, Japanese, Korean, French, or Russian; MiniMax maps the same field to language_boost","title":"Language Type"},"language":{"anyOf":[{"maxLength":35,"type":"string"},{"type":"null"}],"default":null,"description":"xAI BCP-47 language code or 'auto'","title":"Language"},"persist":{"default":"temp","description":"Storage mode: 'none' (base64 only), 'temp' (S3, 7-day expiry), 'library' (permanent post).","enum":["none","temp","library"],"title":"Persist","type":"string"},"conversation_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Conversation ID for cost tracking","title":"Conversation Id"},"sample_rate":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Output sample rate in Hz (xAI or Qwen-Audio): 8000, 16000, 22050, 24000, 44100, 48000","title":"Sample Rate"},"bit_rate":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"xAI MP3 bit rate: 32000, 64000, 96000, 128000, 192000","title":"Bit Rate"},"optimize_streaming_latency":{"anyOf":[{"maximum":2,"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"xAI latency optimization level","title":"Optimize Streaming Latency"},"text_normalization":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"Enable xAI text normalization","title":"Text Normalization"},"with_timestamps":{"default":false,"description":"Return xAI character-level audio timestamps","title":"With Timestamps","type":"boolean"},"replacements":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"default":null,"description":"xAI pronunciation replacements","title":"Replacements"}},"required":["text"],"title":"TTSGenerateRequest","type":"object"},"constraints":[]},"x402":{"method":"POST","path":"/api/v1/x402/tts/generate","auth":"x402","requires_conversation":false,"input_schema":{"$defs":{"TTSProvider":{"enum":["elevenlabs","gemini","openai","z-ai"],"title":"TTSProvider","type":"string"}},"description":"Request to generate speech from text.","properties":{"text":{"description":"Text to convert to speech","maxLength":20000,"minLength":1,"title":"Text","type":"string"},"provider":{"$ref":"#/$defs/TTSProvider","default":"gemini","description":"TTS provider: gemini (default), z-ai, elevenlabs, openai, xai, dashscope, qwen-audio, or minimax"},"voice":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Voice name. Gemini: Kore (default), Aoede, Puck, Charon, etc. Z.AI: tongtong (default), chuichui, xiaochen, jam, kazi, douji, luodo. ElevenLabs: jessica (default), hope, ryan, or a voice ID. OpenAI: coral (default), alloy, ash, ballad, echo, fable, nova, onyx, sage, shimmer, verse, marin, cedar. xAI: eve (default), ara, rex, sal, or another xAI voice ID. DashScope: Cherry (default), another system voice, or an owned designed/cloned voice ID. MiniMax: English_Graceful_Lady (default), another system voice ID, or a cloned/designed voice ID.","title":"Voice"},"style":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"description":"Style prompt (Gemini only)","title":"Style"},"instructions":{"anyOf":[{"maxLength":2000,"type":"string"},{"type":"null"}],"default":null,"description":"Speech instructions for OpenAI or a DashScope instruct model","title":"Instructions"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Model: 'flash'/'pro' (Gemini), 'eleven_v3' (ElevenLabs), 'gpt-4o-mini-tts'/'tts-1'/'tts-1-hd' (OpenAI), or a supported Speech 2.8/2.6 model ID (MiniMax)","title":"Model"},"response_format":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Output format: mp3, opus, aac, flac, wav, pcm (provider support varies)","title":"Response Format"},"speed":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Speech speed (Z.AI and MiniMax: 0.5-2.0, xAI: 0.7-1.5, ElevenLabs: configurable, OpenAI tts-1: 0.25-4.0)","title":"Speed"},"volume":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Volume 0-10 (Z.AI or MiniMax)","title":"Volume"}},"required":["text"],"title":"TTSGenerateRequest","type":"object","allOf":[{"if":{"required":["provider"],"properties":{"provider":{"const":"gemini"}}},"then":{"properties":{"text":{"maxLength":20000},"model":{"enum":[null,"flash","gemini-2.5-flash-preview-tts","gemini-2.5-pro-preview-tts","pro"]}}}},{"if":{"required":["provider"],"properties":{"provider":{"const":"openai"}}},"then":{"properties":{"text":{"maxLength":4096},"model":{"enum":[null,"gpt-4o-mini-tts","tts-1","tts-1-hd"]}}}},{"if":{"required":["provider"],"properties":{"provider":{"const":"elevenlabs"}}},"then":{"properties":{"text":{"maxLength":5000},"model":{"enum":[null,"eleven_flash_v2_5","eleven_multilingual_v2","eleven_turbo_v2_5","eleven_v3"]}}}},{"if":{"required":["provider"],"properties":{"provider":{"const":"z-ai"}}},"then":{"properties":{"text":{"maxLength":1024},"model":{"enum":[null,"glm-tts"]}}}}]},"constraints":["Price follows text length and model; quote before signing.","Character limits: Gemini 20000, OpenAI 4096, ElevenLabs 5000, Z.AI 1024.","Returns audio directly. Cue library and owned catalog voices require credits.","ElevenLabs wallet voices: jessica, hope, ryan."]}},"example":{"text":"Hello from Cue.","provider":"gemini","voice":"Kore","persist":"none"},"models_path":null,"quote_path":"/api/v1/services/speech.generate/quote","recovery":{"request_header":"Idempotency-Key","recommended_request_id_format":"uuid","retention_seconds":604800,"status_path":"/api/v1/services/requests/{request_id}","x402_auth":"original Payment-Signature and recovery secret","recovery_token_header":"X-Cue-Recovery-Token","credits_auth":"bearer"}},{"id":"video.generate","payments":{"credits":{"method":"POST","path":"/api/v1/video/generate","auth":"bearer","requires_conversation":false,"input_schema":{"$defs":{"VideoProvider":{"enum":["veo","sora","seedance","xai","dashscope","minimax"],"title":"VideoProvider","type":"string"},"VideoReferenceMedia":{"description":"Public media reference for reference-to-video generation.","properties":{"type":{"enum":["reference_image","reference_video","first_frame","last_frame"],"title":"Type","type":"string"},"url":{"format":"uri","minLength":1,"title":"Url","type":"string"},"reference_voice":{"anyOf":[{"format":"uri","minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Reference Voice"}},"required":["type","url"],"title":"VideoReferenceMedia","type":"object"}},"properties":{"prompt":{"maxLength":2000,"minLength":1,"title":"Prompt","type":"string"},"conversation_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Video app conversation ID for iteration context (optional)","title":"Conversation Id"},"provider":{"$ref":"#/$defs/VideoProvider","default":"veo"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Model ID (see GET /video/models for available models)","title":"Model"},"aspect_ratio":{"default":"16:9","pattern":"^(\\d+:\\d+|adaptive)$","title":"Aspect Ratio","type":"string"},"resolution":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Resolution: 720p (default) or 1080p","title":"Resolution"},"negative_prompt":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"title":"Negative Prompt"},"duration_seconds":{"anyOf":[{"maximum":15,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Duration in seconds (Veo: 4, 6, or 8; Sora: 4, 8, or 12; Seedance 1.x: 5 or 10; Seedance 2.x: 4-15; xAI: 1-15; MiniMax H3: 4-15)","title":"Duration Seconds"},"generate_audio":{"default":false,"description":"Ask for an audio track. See audio_control on GET /video/models: 'optional' means the model takes this as a choice, 'always_on' means it returns audio either way, 'unsupported' means the model refuses the field.","title":"Generate Audio","type":"boolean"},"reference_media":{"anyOf":[{"items":{"$ref":"#/$defs/VideoReferenceMedia"},"maxItems":7,"minItems":1,"type":"array"},{"type":"null"}],"default":null,"description":"Reference media. xAI accepts up to seven reference images. DashScope accepts up to five image/video references, or a first frame optionally paired with a last frame.","title":"Reference Media"},"reference_voice_ids":{"anyOf":[{"items":{"type":"string"},"maxItems":3,"minItems":1,"type":"array"},{"type":"null"}],"default":null,"description":"xAI preset voice IDs for reference-to-video. Tag them as <AUDIO_0>, <AUDIO_1>, and <AUDIO_2> in the prompt.","title":"Reference Voice Ids"},"prompt_extend":{"default":true,"description":"Enable provider prompt rewriting when supported","title":"Prompt Extend","type":"boolean"},"watermark":{"default":false,"description":"Add the provider watermark when supported","title":"Watermark","type":"boolean"},"title":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Optional title for the video","title":"Title"},"persist":{"default":"temp","description":"Storage mode: 'none' (no S3), 'temp' (S3, 7-day expiry), 'library' (permanent post).","enum":["none","temp","library"],"title":"Persist","type":"string"}},"required":["prompt"],"title":"VideoGenerateRequest","type":"object"},"constraints":[]},"x402":{"method":"POST","path":"/api/v1/x402/video/generate","auth":"x402","requires_conversation":false,"input_schema":{"$defs":{"VideoProvider":{"enum":["veo","sora","seedance"],"title":"VideoProvider","type":"string"},"VideoReferenceMedia":{"description":"Public media reference for reference-to-video generation.","properties":{"type":{"enum":["reference_image","reference_video","first_frame","last_frame"],"title":"Type","type":"string"},"url":{"format":"uri","minLength":1,"title":"Url","type":"string"},"reference_voice":{"anyOf":[{"format":"uri","minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Reference Voice"}},"required":["type","url"],"title":"VideoReferenceMedia","type":"object"}},"properties":{"prompt":{"maxLength":2000,"minLength":1,"title":"Prompt","type":"string"},"provider":{"$ref":"#/$defs/VideoProvider","default":"veo"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Model ID (see GET /video/models for available models)","title":"Model"},"aspect_ratio":{"default":"16:9","pattern":"^(\\d+:\\d+|adaptive)$","title":"Aspect Ratio","type":"string"},"resolution":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Resolution: 720p (default) or 1080p","title":"Resolution"},"negative_prompt":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"title":"Negative Prompt"},"duration_seconds":{"anyOf":[{"maximum":15,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Duration in seconds (Veo: 4, 6, or 8; Sora: 4, 8, or 12; Seedance 1.x: 5 or 10; Seedance 2.x: 4-15; xAI: 1-15; MiniMax H3: 4-15)","title":"Duration Seconds"},"generate_audio":{"default":false,"description":"Ask for an audio track. See audio_control on GET /video/models: 'optional' means the model takes this as a choice, 'always_on' means it returns audio either way, 'unsupported' means the model refuses the field.","title":"Generate Audio","type":"boolean"}},"required":["prompt"],"title":"VideoGenerateRequest","type":"object"},"constraints":["Veo: model veo-3.1-fast-generate-preview; 720p or 1080p; fixed 8 seconds; omit duration_seconds and generate_audio.","Sora: model sora-2; fixed defaults; omit resolution, duration_seconds, and generate_audio.","Seedance: model doubao-seedance-1-5-pro-251215; 5 seconds; omit resolution; generate_audio must be false."]}},"example":{"prompt":"A green ceramic teapot turning slowly","provider":"seedance","model":"doubao-seedance-1-5-pro-251215"},"models_path":"/api/v1/services/video.generate/models","quote_path":"/api/v1/services/video.generate/quote","recovery":{"request_header":"Idempotency-Key","recommended_request_id_format":"uuid","retention_seconds":604800,"status_path":"/api/v1/services/requests/{request_id}","x402_auth":"original Payment-Signature and recovery secret","recovery_token_header":"X-Cue-Recovery-Token","credits_auth":"bearer"}}]