ccapi
🇨🇳简体中文
  • 🇨🇳简体中文
  • 🇺🇸English
Home
Home
🇨🇳简体中文
  • 🇨🇳简体中文
  • 🇺🇸English
🇨🇳简体中文
  • 🇨🇳简体中文
  • 🇺🇸English
  1. Producer
  • openclaw集成文档
  • claude code集成文档
  • codex集成文档
  • gemini cli集成文档
  • Chat
    • Google
      • Generate Content
      • Stream Generate Content
    • OpenAI
      • Create Chat Completion
      • Create Response
    • Anthropic
      • Create Message
    • DeepSeek
      • Create Chat Completion
    • MiniMax
      • Create Chat Completion
  • Image
    • nano banana
      • Generate Image
    • z-image-turbo
      • 集成文档
    • Seedream
      • 集成文档
  • Video
    • Vidu 视频生成
    • Seedance 视频生成
  • Audio
    • Producer
      • 生成音乐
        POST
      • 生成歌词
        POST
      • 延伸音乐
        POST
      • 创建翻唱
        POST
      • 创建变体
        POST
      • 替换片段
        POST
      • 人声替换
        POST
      • 伴奏替换
        POST
      • 音轨分离
        POST
      • 下载音频
        POST
      • 上传音频
        POST
      • 生成视频
        POST
      • 查询任务状态
        GET
      • 批量查询任务
        POST
    • Suno
      • 生成音乐
      • 查询任务状态
      • 生成歌词
      • 延伸音乐
      • 创建翻唱
      • 提取音轨
      • 提取全部音轨
      • 添加人声
      • 添加伴奏
      • 替换片段
      • 重制混音
      • 混搭
      • 采样片段
      • 生成音效
      • 生成 MIDI
      • 上传音频
      • 拼接音乐
      • 获取对齐歌词
      • 生成音乐视频
      • 导出为 WAV
      • 创建声音角色(暂不可用)
      • 检测 BPM
      • 提取人声
      • 扩展标签
      • 批量查询任务
  1. Producer

查询任务状态

GET
https://api.ccapi.ai//producer/fetch/{id}
轮询任意 Producer 异步任务的状态。

状态流转#

NOT_START -> SUBMITTED -> QUEUED -> IN_PROGRESS -> SUCCESS / FAILURE

轮询#

单任务查询:GET /producer/fetch/{id}
批量任务查询:POST /producer/fetch,请求体 {"ids":["task_xxx"]}
建议轮询间隔:10-15 秒
返回的记录仅限于当前身份验证用户或 token 持有者
失败任务自动退费

结果结构#

data 是 CCAPI 持久化的任务记录
data.status 是任务状态
data.progress 是进度字符串,如 20% 或 100%
data.data 是归一化的操作结果数据
音乐类操作通常返回 data.data.clips[]
CCAPI 保持响应结构稳定,不暴露上游 provider 内部细节。

请求参数

Authorization
or
Path 参数

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.ccapi.ai//producer/fetch/task_7f11c4b772f44710ac0fae0d5b3dc4c1'

返回响应

🟢200成功
application/json
任务状态
Body

示例
{
    "code": "success",
    "message": "",
    "data": {
        "id": 3,
        "created_at": 1773385820,
        "updated_at": 1773385828,
        "task_id": "task_BE5vsWPK0pWHyONbGVEXqsPqD6IkcBY6",
        "platform": "producer",
        "user_id": 3,
        "group": "producer-A",
        "channel_id": 28,
        "quota": 30000,
        "action": "MUSIC",
        "status": "IN_PROGRESS",
        "fail_reason": "",
        "submit_time": 1773385820,
        "start_time": 1773385828,
        "finish_time": 0,
        "progress": "20%",
        "properties": {
            "input": "",
            "upstream_model_name": "producer_music",
            "origin_model_name": "producer_music"
        },
        "data": {
            "progress": "20%",
            "status": "IN_PROGRESS",
            "task_id": "ef74a9d9-6c9f-47aa-a771-1006e987e331"
        }
    }
}
🟠400请求有误
🟠401未认证
修改于 2026-03-27 07:48:23
上一页
生成视频
下一页
批量查询任务
Built with