Image, video, music and text generation across 100+ models through one endpoint.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Send a conversation to any text model available through CCAPI (Claude, GPT, Gemini, DeepSeek, GLM, MiniMax, Kimi, Qwen…) and get the reply. Useful for consulting a second model for a different perspective, running a cheap model over bulk work, or reaching a model the current client does not have configured. Responses are non-streaming.
Exact model name, e.g. claude-sonnet-5 or deepseek-v4-pro. Call list_models with category 'text' if unsure.
Conversation so far, oldest first. Must contain at least one message.
Up to 4 sequences that stop generation.
Nucleus sampling probability mass, 0-1. Omit for the model default.
Maximum tokens to generate. Omit for the model default.
Sampling temperature, typically 0-2. Omit for the model default.
Send a conversation to any text model available through CCAPI (Claude, GPT, Gemini, DeepSeek, GLM, MiniMax, Kimi, Qwen…) and get the reply. Useful for consulting a second model for a different perspective, running a cheap model over bulk work, or reaching a model the current client does not have configured. Responses are non-streaming.
| Argument | Type | Description |
|---|---|---|
| stop | null | array | Up to 4 sequences that stop generation. |
| model* | string | Exact model name, e.g. claude-sonnet-5 or deepseek-v4-pro. Call list_models with category 'text' if unsure. |
| top_p | null | number | Nucleus sampling probability mass, 0-1. Omit for the model default. |
| messages* | null | array | Conversation so far, oldest first. Must contain at least one message. |
| max_tokens | null | integer | Maximum tokens to generate. Omit for the model default. |
| temperature | null | number | Sampling temperature, typically 0-2. Omit for the model default. |
{
"type": "object",
"required": [
"model",
"messages"
],
"properties": {
"stop": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
},
"description": "Up to 4 sequences that stop generation."
},
"model": {
"type": "string",
"description": "Exact model name, e.g. claude-sonnet-5 or deepseek-v4-pro. Call list_models with category 'text' if unsure."
},
"top_p": {
"type": [
"null",
"number"
],
"description": "Nucleus sampling probability mass, 0-1. Omit for the model default."
},
"messages": {
"type": [
"null",
"array"
],
"items": {
"type": "object",
"required": [
"role",
"content"
],
"properties": {
"role": {
"type": "string",
"description": "Message author: system, user or assistant."
},
"content": {
"type": "string",
"description": "Message text."
}
},
"additionalProperties": false
},
"description": "Conversation so far, oldest first. Must contain at least one message."
},
"max_tokens": {
"type": [
"null",
"integer"
],
"description": "Maximum tokens to generate. Omit for the model default."
},
"temperature": {
"type": [
"null",
"number"
],
"description": "Sampling temperature, typically 0-2. Omit for the model default."
}
},
"additionalProperties": false
}Edit existing images according to an instruction, using the dedicated image edit endpoint. Provide at least one source image. For pure text-to-image, or for models that take references through the generation endpoint, use generate_image instead.
| Argument | Type | Description |
|---|---|---|
| n | null | integer | How many images to generate. Defaults to 1. Each one is billed. |
| size | string | Output size, e.g. 1024x1024, 1536x1024, or 'auto'. Model-dependent; omit for the model default. |
| async | boolean | Submit asynchronously and return a task_id instead of waiting. Use when the client times out on slow models; poll with get_task using platform 'image'. |
| model* | string | Exact model name, e.g. gpt-image-2 or nano-banana-pro. Call list_models with category 'image' if unsure. |
| images | null | array | Optional reference images as HTTPS URLs or data URLs, for image-to-image generation. Not all models accept references. |
| prompt* | string | Description of the image to generate. |
| quality | string | Quality hint, e.g. low, medium, high or auto. Model-dependent. |
| aspect_ratio | string |
Continue an existing song from a given timestamp, producing a longer version. Requires the clip_id of a previously generated song, which appears in the 'raw' payload of a completed generate_music task. Asynchronous — poll with get_task.
| Argument | Type | Description |
|---|---|---|
| tags | string | Style tags for the extension. |
| title | string | New title for the extended song. |
| prompt | string | Lyrics for the extended section. |
| clip_id* | string | ID of the song to extend, taken from the 'raw' clip list of a completed generate_music task. |
| provider | string | Music backend: 'suno' (default) or 'producer'. |
| continue_at* | number | Timestamp in seconds within the original song to continue from. |
| wait_seconds | null | integer | Poll server-side for up to this many seconds (max 240). |
{
"type": "object",
"required": [
"clip_id",
"continue_at"
],
"properties": {
"tags": {
"type": "string",
"description": "Style tags for the extension."
},
"title": {
"type": "string",
"description": "New title for the extended song."
},
"prompt": {
"type": "string",
"description": "Lyrics for the extended section."
},
"clip_id": {
"type": "string",
"description": "ID of the song to extend, taken from the 'raw' clip list of a completed generate_music task."
},
"provider": {
"type": "string",
"description": "Music backend: 'suno' (default) or 'producer'."
},
"continue_at": {
"type": "number",
"description": "Timestamp in seconds within the original song to continue from."
},
"wait_seconds": {
"type": [
"null",
"integer"
],
"description": "Poll server-side for up to this many seconds (max 240)."
}
},
"additionalProperties": false
}Generate an image from a text prompt, optionally guided by reference images (image-to-image). Returns image URLs directly. Most models finish in 10-60 seconds; if your client times out, set async=true to get a task_id you can poll instead. This call costs money — do not retry speculatively.
| Argument | Type | Description |
|---|---|---|
| n | null | integer | How many images to generate. Defaults to 1. Each one is billed. |
| size | string | Output size, e.g. 1024x1024, 1536x1024, or 'auto'. Model-dependent; omit for the model default. |
| async | boolean | Submit asynchronously and return a task_id instead of waiting. Use when the client times out on slow models; poll with get_task using platform 'image'. |
| model* | string | Exact model name, e.g. gpt-image-2 or nano-banana-pro. Call list_models with category 'image' if unsure. |
| images | null | array | Optional reference images as HTTPS URLs or data URLs, for image-to-image generation. Not all models accept references. |
| prompt* | string | Description of the image to generate. |
| quality | string | Quality hint, e.g. low, medium, high or auto. Model-dependent. |
| aspect_ratio |
Write song lyrics from a description, without generating audio. Useful as a first step before generate_music with custom=true, so the user can approve the words before paying for audio. Asynchronous — poll with get_task.
| Argument | Type | Description |
|---|---|---|
| prompt* | string | Description of the lyrics to write, e.g. 'a love song about meeting someone at a coffee shop'. |
| provider | string | Music backend: 'suno' (default) or 'producer'. |
| lyrics_model | string | Lyrics model: classic or remi. |
| wait_seconds | null | integer | Poll server-side for up to this many seconds (max 240). Lyrics usually finish in under 30 seconds. |
{
"type": "object",
"required": [
"prompt"
],
"properties": {
"prompt": {
"type": "string",
"description": "Description of the lyrics to write, e.g. 'a love song about meeting someone at a coffee shop'."
},
"provider": {
"type": "string",
"description": "Music backend: 'suno' (default) or 'producer'."
},
"lyrics_model": {
"type": "string",
"description": "Lyrics model: classic or remi."
},
"wait_seconds": {
"type": [
"null",
"integer"
],
"description": "Poll server-side for up to this many seconds (max 240). Lyrics usually finish in under 30 seconds."
}
},
"additionalProperties": false
}Generate a song with vocals or instrumental. Two modes: simple (custom=false) where you describe the song and the model writes the lyrics, or custom (custom=true) where you supply lyrics, title and style tags. Asynchronous — returns a task_id you poll with get_task; generation usually takes 30-120 seconds and normally yields two variations.
| Argument | Type | Description |
|---|---|---|
| tags | string | Comma-separated style tags, e.g. 'pop, upbeat, guitar'. Max 200 characters. |
| model | string | Suno model version, e.g. chirp-v5 or chirp-v4-5-plus. Omit for the platform default. |
| title | string | Song title. Used in custom mode. |
| custom | boolean | false (default) lets the model write the lyrics from your description; true means prompt contains lyrics you wrote and you should also set title and tags. |
| prompt* | string | In simple mode (custom=false) a description of the song, e.g. 'a dreamy lo-fi track about late-night trains'. In custom mode (custom=true) the actual lyrics, with section markers like [Verse] and [Chorus]. |
| provider | string | Music backend: 'suno' (default) or 'producer'. |
| instrumental | boolean | Generate without vocals. |
| wait_seconds |
Generate a video from a text prompt, optionally driven by reference images (image-to-video, first/last frame). This is asynchronous: it returns a task_id you poll with get_task(platform='video'). Generation usually takes 30-180 seconds. Pass wait_seconds to have the server poll for you. Video generation is the most expensive capability here — confirm the prompt with the user before spending on retries.
| Argument | Type | Description |
|---|---|---|
| model* | string | Exact model name, e.g. doubao-seedance-2-0-260128, veo-3.1-quality or viduq3-pro. Call list_models with category 'video' if unsure. |
| ratio | string | Aspect ratio, e.g. 16:9, 9:16, 1:1, 21:9 or adaptive. Which values a model accepts varies; an unsupported one is rejected with a message naming the valid ones. |
| audios | null | array | Optional Seedance reference audio URLs or asset:// URIs returned by the trusted asset catalog. Reference audio cannot be used alone. |
| images | null | array | Optional reference image URLs. A single image is used as the first frame; use image_roles to control multiple. |
| prompt* | string | Description of the video to generate. |
| videos | null | array | Optional Seedance reference video URLs or asset:// URIs returned by the trusted asset catalog. |
| duration | null | integer |
Report the remaining and used balance for this CCAPI key. Useful before starting an expensive batch of generations, or to explain a quota failure to the user.
No arguments.
{
"type": "object",
"additionalProperties": false
}Check the status of an asynchronous generation task submitted by generate_video, generate_music, generate_lyrics, extend_music, or generate_image with async=true. Pass the platform and task_id exactly as they were returned. Status is one of queued, in_progress, completed or failed; poll every few seconds until it settles, or pass wait_seconds to have the server wait for you.
| Argument | Type | Description |
|---|---|---|
| task_id* | string | Task identifier returned by the submit tool. |
| platform* | string | Platform the task belongs to, exactly as returned by the submit tool: image, video, suno or producer. |
| wait_seconds | null | integer | Poll server-side for up to this many seconds (max 240) and return once the task finishes. Omit for a single immediate status check. |
{
"type": "object",
"required": [
"platform",
"task_id"
],
"properties": {
"task_id": {
"type": "string",
"description": "Task identifier returned by the submit tool."
},
"platform": {
"type": "string",
"description": "Platform the task belongs to, exactly as returned by the submit tool: image, video, suno or producer."
},
"wait_seconds": {
"type": [
"null",
"integer"
],
"description": "Poll server-side for up to this many seconds (max 240) and return once the task finishes. Omit for a single immediate status check."
}
},
"additionalProperties": false
}List the AI models this CCAPI key can actually call, with their capability category and the MCP tool that drives them. Call this before generating anything if you are unsure a model name is valid — availability depends on the key's group and changes over time. Never guess model names.
| Argument | Type | Description |
|---|---|---|
| search | string | Case-insensitive substring match on the model name, e.g. 'claude' or 'seedance'. |
| category | string | Filter by capability. One of: text, image, video, music, embedding, other. Omit to list every model this key can use. |
{
"type": "object",
"properties": {
"search": {
"type": "string",
"description": "Case-insensitive substring match on the model name, e.g. 'claude' or 'seedance'."
},
"category": {
"type": "string",
"description": "Filter by capability. One of: text, image, video, music, embedding, other. Omit to list every model this key can use."
}
},
"additionalProperties": false
}Increase the resolution of an existing image 2x with ccapi-upscale-v1. Input must be between 256x256 and 1024x1024 and under 5 MB; for larger inputs, regenerate with a high-resolution model instead.
| Argument | Type | Description |
|---|---|---|
| image* | string | The image to upscale, as an HTTPS URL, data URL, or raw base64. Width and height must each be 256-1024 px and the file at most 5 MB. |
| model_quality | string | Upscale quality hint: HQ, MQ (default) or LQ. |
| response_format | string | 'url' (default) or 'b64_json'. |
{
"type": "object",
"required": [
"image"
],
"properties": {
"image": {
"type": "string",
"description": "The image to upscale, as an HTTPS URL, data URL, or raw base64. Width and height must each be 256-1024 px and the file at most 5 MB."
},
"model_quality": {
"type": "string",
"description": "Upscale quality hint: HQ, MQ (default) or LQ."
},
"response_format": {
"type": "string",
"description": "'url' (default) or 'b64_json'."
}
},
"additionalProperties": false
}| Z-Image only: required output aspect ratio. Supported values: 1:1, 4:3, 3:4, 16:9, 9:16. |
| nsfw_checker | null | boolean | Z-Image only: enable or disable the upstream NSFW checker. Explicit false is preserved. |
| wait_seconds | null | integer | Only with async: poll server-side for up to this many seconds (max 240) and return the finished image if it completes in time. |
| response_format | string | 'url' (default) returns links; 'b64_json' returns base64 data, which is far larger and usually unnecessary. |
{
"type": "object",
"required": [
"model",
"prompt"
],
"properties": {
"n": {
"type": [
"null",
"integer"
],
"description": "How many images to generate. Defaults to 1. Each one is billed."
},
"size": {
"type": "string",
"description": "Output size, e.g. 1024x1024, 1536x1024, or 'auto'. Model-dependent; omit for the model default."
},
"async": {
"type": "boolean",
"description": "Submit asynchronously and return a task_id instead of waiting. Use when the client times out on slow models; poll with get_task using platform 'image'."
},
"model": {
"type": "string",
"description": "Exact model name, e.g. gpt-image-2 or nano-banana-pro. Call list_models with category 'image' if unsure."
},
"images": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
},
"description": "Optional reference images as HTTPS URLs or data URLs, for image-to-image generation. Not all models accept references."
},
"prompt": {
"type": "string",
"description": "Description of the image to generate."
},
"quality": {
"type": "string",
"description": "Quality hint, e.g. low, medium, high or auto. Model-dependent."
},
"aspect_ratio": {
"type": "string",
"description": "Z-Image only: required output aspect ratio. Supported values: 1:1, 4:3, 3:4, 16:9, 9:16."
},
"nsfw_checker": {
"type": [
"null",
"boolean"
],
"description": "Z-Image only: enable or disable the upstream NSFW checker. Explicit false is preserved."
},
"wait_seconds": {
"type": [
"null",
"integer"
],
"description": "Only with async: poll server-side for up to this many seconds (max 240) and return the finished image if it completes in time."
},
"response_format": {
"type": "string",
"description": "'url' (default) returns links; 'b64_json' returns base64 data, which is far larger and usually unnecessary."
}
},
"additionalProperties": false
}| string |
| Z-Image only: required output aspect ratio. Supported values: 1:1, 4:3, 3:4, 16:9, 9:16. |
| nsfw_checker | null | boolean | Z-Image only: enable or disable the upstream NSFW checker. Explicit false is preserved. |
| wait_seconds | null | integer | Only with async: poll server-side for up to this many seconds (max 240) and return the finished image if it completes in time. |
| response_format | string | 'url' (default) returns links; 'b64_json' returns base64 data, which is far larger and usually unnecessary. |
{
"type": "object",
"required": [
"model",
"prompt"
],
"properties": {
"n": {
"type": [
"null",
"integer"
],
"description": "How many images to generate. Defaults to 1. Each one is billed."
},
"size": {
"type": "string",
"description": "Output size, e.g. 1024x1024, 1536x1024, or 'auto'. Model-dependent; omit for the model default."
},
"async": {
"type": "boolean",
"description": "Submit asynchronously and return a task_id instead of waiting. Use when the client times out on slow models; poll with get_task using platform 'image'."
},
"model": {
"type": "string",
"description": "Exact model name, e.g. gpt-image-2 or nano-banana-pro. Call list_models with category 'image' if unsure."
},
"images": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
},
"description": "Optional reference images as HTTPS URLs or data URLs, for image-to-image generation. Not all models accept references."
},
"prompt": {
"type": "string",
"description": "Description of the image to generate."
},
"quality": {
"type": "string",
"description": "Quality hint, e.g. low, medium, high or auto. Model-dependent."
},
"aspect_ratio": {
"type": "string",
"description": "Z-Image only: required output aspect ratio. Supported values: 1:1, 4:3, 3:4, 16:9, 9:16."
},
"nsfw_checker": {
"type": [
"null",
"boolean"
],
"description": "Z-Image only: enable or disable the upstream NSFW checker. Explicit false is preserved."
},
"wait_seconds": {
"type": [
"null",
"integer"
],
"description": "Only with async: poll server-side for up to this many seconds (max 240) and return the finished image if it completes in time."
},
"response_format": {
"type": "string",
"description": "'url' (default) returns links; 'b64_json' returns base64 data, which is far larger and usually unnecessary."
}
},
"additionalProperties": false
}| null | integer |
| Poll server-side for up to this many seconds (max 240) and return finished audio if it completes in time. Omit to return a task_id immediately. |
| negative_tags | string | Styles to avoid, e.g. 'heavy metal, rap'. |
{
"type": "object",
"required": [
"prompt"
],
"properties": {
"tags": {
"type": "string",
"description": "Comma-separated style tags, e.g. 'pop, upbeat, guitar'. Max 200 characters."
},
"model": {
"type": "string",
"description": "Suno model version, e.g. chirp-v5 or chirp-v4-5-plus. Omit for the platform default."
},
"title": {
"type": "string",
"description": "Song title. Used in custom mode."
},
"custom": {
"type": "boolean",
"description": "false (default) lets the model write the lyrics from your description; true means prompt contains lyrics you wrote and you should also set title and tags."
},
"prompt": {
"type": "string",
"description": "In simple mode (custom=false) a description of the song, e.g. 'a dreamy lo-fi track about late-night trains'. In custom mode (custom=true) the actual lyrics, with section markers like [Verse] and [Chorus]."
},
"provider": {
"type": "string",
"description": "Music backend: 'suno' (default) or 'producer'."
},
"instrumental": {
"type": "boolean",
"description": "Generate without vocals."
},
"wait_seconds": {
"type": [
"null",
"integer"
],
"description": "Poll server-side for up to this many seconds (max 240) and return finished audio if it completes in time. Omit to return a task_id immediately."
},
"negative_tags": {
"type": "string",
"description": "Styles to avoid, e.g. 'heavy metal, rap'."
}
},
"additionalProperties": false
}| Clip length in seconds. Model-dependent, typically 4-15; an unsupported value is rejected with a message naming the supported ones. Omit for the model default. |
| resolution | string | Output resolution: 480p, 720p (widest compatibility) or 1080p. Model-dependent. |
| image_roles | null | array | Role of each entry in images, positionally: first_frame, last_frame or reference_image. |
| wait_seconds | null | integer | Poll server-side for up to this many seconds (max 240) and return the finished video if it completes in time. Omit to return a task_id immediately. |
| generate_audio | null | boolean | Generate a synchronised soundtrack. Only some models support this. |
{
"type": "object",
"required": [
"model",
"prompt"
],
"properties": {
"model": {
"type": "string",
"description": "Exact model name, e.g. doubao-seedance-2-0-260128, veo-3.1-quality or viduq3-pro. Call list_models with category 'video' if unsure."
},
"ratio": {
"type": "string",
"description": "Aspect ratio, e.g. 16:9, 9:16, 1:1, 21:9 or adaptive. Which values a model accepts varies; an unsupported one is rejected with a message naming the valid ones."
},
"audios": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
},
"description": "Optional Seedance reference audio URLs or asset:// URIs returned by the trusted asset catalog. Reference audio cannot be used alone."
},
"images": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
},
"description": "Optional reference image URLs. A single image is used as the first frame; use image_roles to control multiple."
},
"prompt": {
"type": "string",
"description": "Description of the video to generate."
},
"videos": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
},
"description": "Optional Seedance reference video URLs or asset:// URIs returned by the trusted asset catalog."
},
"duration": {
"type": [
"null",
"integer"
],
"description": "Clip length in seconds. Model-dependent, typically 4-15; an unsupported value is rejected with a message naming the supported ones. Omit for the model default."
},
"resolution": {
"type": "string",
"description": "Output resolution: 480p, 720p (widest compatibility) or 1080p. Model-dependent."
},
"image_roles": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
},
"description": "Role of each entry in images, positionally: first_frame, last_frame or reference_image."
},
"wait_seconds": {
"type": [
"null",
"integer"
],
"description": "Poll server-side for up to this many seconds (max 240) and return the finished video if it completes in time. Omit to return a task_id immediately."
},
"generate_audio": {
"type": [
"null",
"boolean"
],
"description": "Generate a synchronised soundtrack. Only some models support this."
}
},
"additionalProperties": false
}