{"schemaVersion":1,"slug":"ai","name":"AI","description":"Text and image generation with vendor routing, fallback, your own provider keys and shared billing; model catalogue; embeddings.","actions":[{"name":"text","summary":"Generate text with the best available model, with automatic vendor fallback","module":"create","method":"POST","path":"/api/v1/text","inputSchema":{"type":"object","required":["prompt"],"properties":{"prompt":{"type":"string","maxLength":10000,"description":"What to write or answer"},"system_prompt":{"type":"string","maxLength":5000,"description":"Optional instructions for the model"},"max_tokens":{"type":"integer","minimum":1,"maximum":8192},"response_format":{"type":"string","enum":["json"],"description":"Ask for a JSON object"},"image_url":{"type":"string","description":"https URL of an image to look at (vision models only)"},"model":{"type":"string","maxLength":150,"description":"Canonical model key from the models action; omit for the default"},"brand_id":{"type":"string","description":"Brand to bill and file under; omit for Personal"}}}},{"name":"image","summary":"Generate an image (Gemini, OpenAI, fal or Replicate models)","module":"create","method":"POST","path":"/api/v1/images","inputSchema":{"type":"object","required":["prompt"],"properties":{"prompt":{"type":"string","maxLength":5000},"role":{"type":"string","enum":["image_gemini","image_openai","image_fal","image_replicate"],"description":"Which vendor family; default image_gemini"},"quality":{"type":"string","enum":["low","medium","high"],"description":"OpenAI only; affects price"},"aspect_ratio":{"type":"string","maxLength":150,"description":"e.g. 1:1, 16:9"},"width":{"type":"integer","minimum":64,"maximum":4096},"height":{"type":"integer","minimum":64,"maximum":4096},"brand_id":{"type":"string","description":"Brand to bill and file under; omit for Personal"}}}},{"name":"embeddings","summary":"Turn one or many texts into embedding vectors (OpenAI-compatible)","module":"create","method":"POST","path":"/api/v1/embeddings","inputSchema":{"type":"object","required":["input"],"properties":{"input":{"description":"A text or an array of up to 256 texts","anyOf":[{"type":"string","maxLength":30000},{"type":"array","maxItems":256,"items":{"type":"string","maxLength":30000}}]},"model":{"type":"string","enum":["text-embedding-3-small","text-embedding-3-large"],"description":"Default text-embedding-3-small"},"dimensions":{"type":"integer","minimum":8,"maximum":3072,"description":"Shorten the vector (model maximum applies)"},"brand_id":{"type":"string","description":"Brand to bill and file under; omit for Personal"}}}},{"name":"models","summary":"List the models available for a role","module":"create","method":"GET","path":"/api/v1/models","inputSchema":{"type":"object","properties":{"role":{"type":"string","enum":["text_default","image_gemini","image_openai","image_fal","image_replicate"]}}}}]}