API 文档

模型和能力由后台配置。创建请求前先查询模型列表，可以避免模型下线、参数变化或名称调整造成的失败。

查询账号和积分

curl https://api.picccai.cn/v1/user \
  -H "Authorization: Bearer $PICCC_API_KEY"

重点关注 credits。图片和视频任务在创建时扣积分，文本请求按模型定价和 token 用量结算。

文本模型

curl https://api.picccai.cn/v1/models \
  -H "Authorization: Bearer $PICCC_API_KEY"

GET /v1/chat/models 返回同一份列表。

{
  "object": "list",
  "data": [
    {
      "id": "YOUR_MODEL_NAME",
      "object": "model",
      "created": 1782950400,
      "owned_by": "piccc-ai",
      "description": "模型说明"
    }
  ]
}

调用文本接口时，model 必须使用 data[].id，也就是后台显示的模型名称。不要使用上游厂商的内部模型 ID。

图片模型

curl https://api.picccai.cn/v1/images/models \
  -H "Authorization: Bearer $PICCC_API_KEY"

{
  "object": "list",
  "data": [
    {
      "id": "image-model-id",
      "name": "图片模型名称",
      "description": "模型说明",
      "supported_aspect_ratios": ["1:1", "16:9"],
      "supported_resolutions": ["1K", "2K"],
      "supported_qualities": ["standard", "high"],
      "max_n": 4
    }
  ]
}

创建任务时，比例、分辨率、质量和数量应从该模型返回的范围中选择。

视频模型

curl https://api.picccai.cn/v1/videos/models \
  -H "Authorization: Bearer $PICCC_API_KEY"

{
  "object": "list",
  "data": [
    {
      "id": "video-model-id",
      "name": "视频模型名称",
      "supported_resolutions": ["720p", "1080p"],
      "supported_aspect_ratios": ["16:9", "9:16"],
      "duration": {"min": 5, "max": 10, "step": 1},
      "route_modes": ["text_to_video"],
      "reference_modes": ["text_to_video"]
    }
  ]
}

不要假设所有视频模型支持相同的时长和模式。把模型列表缓存在应用内时，建议设置较短的有效期，并在 model is not available 后重新获取一次。