Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, email [email protected] and we’ll put it right.

CCAPI

REMOTE · API.CCAPI.AI · SCANNED AUG 3

Image, video, music and text generation across 100+ models through one endpoint.

Available components

73 Trust /100
Trust breakdown (6 categories)

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. How we score →

Endpoint Security89
Transport & Reachability100
Schema Quality & AI Usability61
  • AI-judged instruction clarity (excellent).Pass
  • Context-footprint check failed: tool/resource definitions use about 2785 tokens (~253/item across 11 items; 11 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
  • Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management3
  • Stability observed for 1 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage100
  • 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
  • 100% of tool parameters carry a description.Pass
  • Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass
Capabilities100
  • Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

remote · api.ccapi.ai

# add to Claude Code
claude mcp add --transport http ai-ccapi-mcp https://api.ccapi.ai/mcp
# ~/.codex/config.toml
[mcp_servers.ai-ccapi-mcp]
url = "https://api.ccapi.ai/mcp"
// opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "ai-ccapi-mcp": {
      "type": "remote",
      "url": "https://api.ccapi.ai/mcp",
      "enabled": true
    }
  }
}
# add to OpenClaw
openclaw mcp add ai-ccapi-mcp --url https://api.ccapi.ai/mcp --transport streamable-http
# ~/.hermes/config.yaml
mcp_servers:
  ai-ccapi-mcp:
    url: "https://api.ccapi.ai/mcp"
// mcp.json
{
  "mcpServers": {
    "ai-ccapi-mcp": {
      "type": "http",
      "url": "https://api.ccapi.ai/mcp"
    }
  }
}

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

  • 3 Aug 26 0
    • Stability: unverified → 0.03 functional
  • 2 Aug 26 73

    First indexed and scored.

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 3 Aug 2026 · Probed https://api.ccapi.ai/mcp

TLS valid

Negotiated TLS 1.3 with TLS_AES_256_GCM_SHA384 .

Subject Issuer Valid from Valid until Key Signature Serial
CN=ccapi.ai CN=YR2,O=Let's Encrypt,C=US 13 Jul 2026 11 Oct 2026 RSA 2048 SHA256-RSA 570314afc4713db9f387990b201464c6d12
SANs: api.ccapi.ai, ccapi.ai
CN=YR2,O=Let's Encrypt,C=US (CA) CN=Root YR,O=ISRG,C=US 3 Sept 2025 2 Sept 2028 RSA 2048 SHA256-RSA 4ebd24947e24d394802d84a52fd5b319
CN=Root YR,O=ISRG,C=US (CA) CN=ISRG Root X1,O=Internet Security Research Group,C=US 13 May 2026 2 Sept 2032 RSA 4096 SHA256-RSA f24b6d17f9d9ad7cb1c9fea78782699f
DNSSEC insecure

Validation of api.ccapi.ai. Not signed

Zone DS Keys Algorithms Outcome
. trust_anchor 20326, 38696 8, 8 Verified
ai. present 3799 8 Verified
ccapi.ai. absent Unsigned (proven) parent-signed NSEC/NSEC3 proves an unsigned delegation
Authentication Challenged, unverified

The endpoint asked for a token, but we could not retrieve and validate the RFC 9728 metadata that tells a client how to obtain one.

Result Challenged, unverified
Enforced On tool calls
HTTP status 200
Header Value
strict-transport-security max-age=31536000; includeSubDomains

Protected resource metadata

Retrieved No
Problem no_resource_metadata
Transports 2 probes
Transport URL Outcome Status Location
streamable-http https://api.ccapi.ai/mcp Verified 200
http (plaintext) http://api.ccapi.ai/mcp HTTPS enforced 308 https://api.ccapi.ai/mcp
MCP tools — 11 exposed · ~2,590 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens
chat_completion ~231

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.

NameTypeReqDescription
max_tokensnull|integerMaximum tokens to generate. Omit for the model default.
messagesnull|arrayyesConversation so far, oldest first. Must contain at least one message.
modelstringyesExact model name, e.g. claude-sonnet-5 or deepseek-v4-pro. Call list_models with category 'text' if unsure.
stopnull|arrayUp to 4 sequences that stop generation.
temperaturenull|numberSampling temperature, typically 0-2. Omit for the model default.
top_pnull|numberNucleus sampling probability mass, 0-1. Omit for the model default.
NameTypeReqDescription
contentstringyesThe model's reply text.
finish_reasonstringWhy generation stopped, e.g. stop or length.
modelstringyesModel that actually served the request.
usageobjectyesToken accounting for this call.

No examples provided.

edit_image ~398

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.

NameTypeReqDescription
aspect_ratiostringZ-Image only: required output aspect ratio. Supported values: 1:1, 4:3, 3:4, 16:9, 9:16.
asyncbooleanSubmit 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'.
imagesnull|arrayOptional reference images as HTTPS URLs or data URLs, for image-to-image generation. Not all models accept references.
modelstringyesExact model name, e.g. gpt-image-2 or nano-banana-pro. Call list_models with category 'image' if unsure.
nnull|integerHow many images to generate. Defaults to 1. Each one is billed.
nsfw_checkernull|booleanZ-Image only: enable or disable the upstream NSFW checker. Explicit false is preserved.
promptstringyesDescription of the image to generate.
qualitystringQuality hint, e.g. low, medium, high or auto. Model-dependent.
response_formatstring'url' (default) returns links; 'b64_json' returns base64 data, which is far larger and usually unnecessary.
sizestringOutput size, e.g. 1024x1024, 1536x1024, or 'auto'. Model-dependent; omit for the model default.
wait_secondsnull|integerOnly with async: poll server-side for up to this many seconds (max 240) and return the finished image if it completes in time.
NameTypeReqDescription
imagesnull|arrayGenerated images, when the call completed.
modelstringyesModel that served the request.
notestringWhat to do next.
platformstringPass this to get_task together with task_id.
statusstringyesOne of: completed, queued, in_progress, failed.
task_idstringTask identifier, when submitted asynchronously and still running.

No examples provided.

extend_music ~182

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.

NameTypeReqDescription
clip_idstringyesID of the song to extend, taken from the 'raw' clip list of a completed generate_music task.
continue_atnumberyesTimestamp in seconds within the original song to continue from.
promptstringLyrics for the extended section.
providerstringMusic backend: 'suno' (default) or 'producer'.
tagsstringStyle tags for the extension.
titlestringNew title for the extended song.
wait_secondsnull|integerPoll server-side for up to this many seconds (max 240).
NameTypeReqDescription
audio_urlsnull|arrayFinished audio URLs, when the task completed within wait_seconds.
notestringyesWhat to do next.
platformstringyes'suno' or 'producer'. Pass to get_task.
rawFull result payload when completed — clip IDs, lyrics text and per-clip metadata. Clip IDs from here are what extend_music takes.
statusstringyesOne of: queued, in_progress, completed, failed.
task_idstringyesPass this to get_task together with platform to check progress.

No examples provided.

generate_image ~418

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.

NameTypeReqDescription
aspect_ratiostringZ-Image only: required output aspect ratio. Supported values: 1:1, 4:3, 3:4, 16:9, 9:16.
asyncbooleanSubmit 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'.
imagesnull|arrayOptional reference images as HTTPS URLs or data URLs, for image-to-image generation. Not all models accept references.
modelstringyesExact model name, e.g. gpt-image-2 or nano-banana-pro. Call list_models with category 'image' if unsure.
nnull|integerHow many images to generate. Defaults to 1. Each one is billed.
nsfw_checkernull|booleanZ-Image only: enable or disable the upstream NSFW checker. Explicit false is preserved.
promptstringyesDescription of the image to generate.
qualitystringQuality hint, e.g. low, medium, high or auto. Model-dependent.
response_formatstring'url' (default) returns links; 'b64_json' returns base64 data, which is far larger and usually unnecessary.
sizestringOutput size, e.g. 1024x1024, 1536x1024, or 'auto'. Model-dependent; omit for the model default.
wait_secondsnull|integerOnly with async: poll server-side for up to this many seconds (max 240) and return the finished image if it completes in time.
NameTypeReqDescription
imagesnull|arrayGenerated images, when the call completed.
modelstringyesModel that served the request.
notestringWhat to do next.
platformstringPass this to get_task together with task_id.
statusstringyesOne of: completed, queued, in_progress, failed.
task_idstringTask identifier, when submitted asynchronously and still running.

No examples provided.

generate_lyrics ~147

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.

NameTypeReqDescription
lyrics_modelstringLyrics model: classic or remi.
promptstringyesDescription of the lyrics to write, e.g. 'a love song about meeting someone at a coffee shop'.
providerstringMusic backend: 'suno' (default) or 'producer'.
wait_secondsnull|integerPoll server-side for up to this many seconds (max 240). Lyrics usually finish in under 30 seconds.
NameTypeReqDescription
audio_urlsnull|arrayFinished audio URLs, when the task completed within wait_seconds.
notestringyesWhat to do next.
platformstringyes'suno' or 'producer'. Pass to get_task.
rawFull result payload when completed — clip IDs, lyrics text and per-clip metadata. Clip IDs from here are what extend_music takes.
statusstringyesOne of: queued, in_progress, completed, failed.
task_idstringyesPass this to get_task together with platform to check progress.

No examples provided.

generate_music ~338

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.

NameTypeReqDescription
custombooleanfalse (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.
instrumentalbooleanGenerate without vocals.
modelstringSuno model version, e.g. chirp-v5 or chirp-v4-5-plus. Omit for the platform default.
negative_tagsstringStyles to avoid, e.g. 'heavy metal, rap'.
promptstringyesIn 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 [Ch…
providerstringMusic backend: 'suno' (default) or 'producer'.
tagsstringComma-separated style tags, e.g. 'pop, upbeat, guitar'. Max 200 characters.
titlestringSong title. Used in custom mode.
wait_secondsnull|integerPoll 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.
NameTypeReqDescription
audio_urlsnull|arrayFinished audio URLs, when the task completed within wait_seconds.
notestringyesWhat to do next.
platformstringyes'suno' or 'producer'. Pass to get_task.
rawFull result payload when completed — clip IDs, lyrics text and per-clip metadata. Clip IDs from here are what extend_music takes.
statusstringyesOne of: queued, in_progress, completed, failed.
task_idstringyesPass this to get_task together with platform to check progress.

No examples provided.

generate_video ~398

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.

NameTypeReqDescription
durationnull|integerClip 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.
generate_audionull|booleanGenerate a synchronised soundtrack. Only some models support this.
image_rolesnull|arrayRole of each entry in images, positionally: first_frame, last_frame or reference_image.
imagesnull|arrayOptional reference image URLs. A single image is used as the first frame; use image_roles to control multiple.
modelstringyesExact model name, e.g. doubao-seedance-2-0-260128, veo-3.1-quality or viduq3-pro. Call list_models with category 'video' if unsure.
promptstringyesDescription of the video to generate.
ratiostringAspect 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.
resolutionstringOutput resolution: 480p, 720p (widest compatibility) or 1080p. Model-dependent.
wait_secondsnull|integerPoll 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.
NameTypeReqDescription
modelstringyesModel that accepted the request.
notestringyesWhat to do next.
platformstringyesAlways 'video'. Pass to get_task.
statusstringyesOne of: queued, in_progress, completed, failed.
task_idstringyesPass this to get_task together with platform to check progress.
video_urlsnull|arrayFinished video URLs, when the task completed within wait_seconds.

No examples provided.

get_balance ~39

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.

Input schema present but exposes no named parameters.

NameTypeReqDescription
currencystringyesUnit of the amounts above, e.g. USD.
notestringGuidance when the balance is low, unlimited, or scoped to a token.
remaining_amountnumberRemaining balance, in the account's display currency. Omitted when unlimited.
total_amountnumberRemaining plus used. Omitted when unlimited.
unlimitedbooleanyesTrue when this token has no spending cap, in which case the amount fields are not meaningful.
used_amountnumberyesBalance consumed to date, in the same unit.

No examples provided.

get_task ~166

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.

NameTypeReqDescription
platformstringyesPlatform the task belongs to, exactly as returned by the submit tool: image, video, suno or producer.
task_idstringyesTask identifier returned by the submit tool.
wait_secondsnull|integerPoll server-side for up to this many seconds (max 240) and return once the task finishes. Omit for a single immediate status check.
NameTypeReqDescription
fail_reasonstringWhy the task failed, when status is failed.
notestringWhat to do next.
platformstringyesPlatform the task belongs to.
progressstringProgress indication, when the backend reports one.
rawBackend payload, for details this summary does not cover (lyrics text, per-clip metadata, seeds).
result_urlsnull|arrayFinished asset URLs. May expire; download anything worth keeping.
statusstringyesOne of: queued, in_progress, completed, failed, unknown.
task_idstringyesThe task this status refers to.

No examples provided.

list_models ~128

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.

NameTypeReqDescription
categorystringFilter by capability. One of: text, image, video, music, embedding, other. Omit to list every model this key can use.
searchstringCase-insensitive substring match on the model name, e.g. 'claude' or 'seedance'.
NameTypeReqDescription
modelsnull|arrayyesModels available to the calling key.
notestringGuidance about the result set.
totalintegeryesNumber of models returned.

No examples provided.

upscale_image ~145

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.

NameTypeReqDescription
imagestringyesThe 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_qualitystringUpscale quality hint: HQ, MQ (default) or LQ.
response_formatstring'url' (default) or 'b64_json'.
NameTypeReqDescription
imagesnull|arrayGenerated images, when the call completed.
modelstringyesModel that served the request.
notestringWhat to do next.
platformstringPass this to get_task together with task_id.
statusstringyesOne of: completed, queued, in_progress, failed.
task_idstringTask identifier, when submitted asynchronously and still running.

No examples provided.