1. 前置准备
拍我AI 开放平台
  • 开始使用
    • 了解计费和用量
    • 联系我们
    • 服务条款
    • 隐私政策
    • 模型能力地图
    • API介绍
    • 快速开始
  • API
    • 前置准备
      • 开始使用
      • 并发规则
      • 查询任务状态说明
      • 错误码
      • 错误详情
      • FAQ
      • Webhook 回调
      • 上传图片
        POST
      • 上传资源(视频/音频)
        POST
      • 获取特效模板列表
        GET
      • 获取 TTS 音色列表
        GET
      • 获取视频重绘列表
        GET
      • 获取用量扣减情况
        POST
      • 查询任务状态
        GET
      • 创建自定义音色
        POST
    • 基础能力
      • 文生视频
      • 图生视频 / 视频模板
      • 图片模版生成
      • 首尾帧生成视频
      • 多主体多参考图 / 视频参考
      • 智能多帧 / 多帧过渡视频
      • 视频延长 Video Extend
      • 视频扩幅 Video Expand
    • 解决方案
      • 超清视频
      • 视频重绘 Restyle
      • 对口型 Lipsync
      • 音效生成 Sound Effect
      • Mask 生成
      • 主体替换 Swap
      • 动作模仿 Motion Control
      • 图片数字人 Avatar
      • 爆款复刻 Agent
      • 房产视频一键成片Agent
      • 一键音乐MV(Music Video)
  • 计费
    • PixVerse API 计费规则
  • 更新日志
    • 更新日志
  • 数据模型
    • VideoExpandResponse
  1. 前置准备

错误码

ErrCode 是响应体中的数字业务错误码,不等同于 HTTP 状态码。ErrCode 为 0 表示请求成功;非零时按下表查询错误含义。不要仅根据 HTTP 状态判断业务是否成功。
以下是带有可选 Error 详情的响应示例:
{
  "ErrCode": 400017,
  "ErrMsg": "Required field prompt are missing or empty.",
  "Resp": null,
  "Error": {
    "Type": "FIELD_REQUIRED",
    "Message": "Required field 'prompt' is missing or empty. Provide a value for this field.",
    "Param": {
      "Fields": [
        "prompt"
      ]
    }
  }
}
ErrMsg 提供简要错误信息;Error.Message 给出具体失败原因和修改建议。
Error.Type、Error.Message 和 Error.Param 是可选的补充错误详情。现有客户端可以继续使用 ErrCode 处理错误;需要更具体的分类或原因时,参见错误详情
任务创建后的执行状态和查询方式参见查询任务状态说明
表中的 ErrMsg 仅为文本示例或概述,不保证与实际响应逐字相同。程序应按数字 ErrCode 分支,不要匹配 ErrMsg 文本。

错误码索引#

下表涵盖 API 调用、账号和平台管理操作。部分错误码在不同操作中含义不同,排查时结合实际返回的消息和对应接口说明。
ErrCodeErrMsg 示例/概述
0success
400Invalid request or operation failed
500Request processing failed
10001Token is invalid
10002Token is expired
10003user is not login
10004apiKey is empty
10005apiKey is not registered
10011Invalid platform or account parameters
99999Unknown error
400002手机号码输入不合规
400007验证码输入不合规
400008validate不能为空
400011Empty parameter
400012Invalid account
400013Invalid binding request: incorrect parameter type or value
400014invalid productId
400015invalid order id
400017Invalid parameter
400018Prompt length exceeds limit
400019Prompt / negative prompt length exceeds limit
400032Invalid image ID
400080Invalid lyrics or lyric timestamps
499001Client closed request.
500007行为式验证码不通过
500008Requested data not found
500020No permission
500030Image size exceeded
500031Failed to retrieve image information
500032Invalid image format
500033Invalid image width or height
500041Image upload failed
500042Invalid image path
500044Concurrent generation limit reached
500047The provided media is invalid — the type may be incorrect, or the resource is no longer available.
500054Content moderation failure
500058This model is currently not supported.
500060Monthly effects activation limit reached
500063Pre-moderation failed
500064Content has been deleted
500069High load
500070Template not activated
500071Unsupported resolution for effect
500073Resolution exceeds membership limits
500081This effect not exist.
500085Invalid query. You can only query your own generated content.
500090Insufficient balance
500100MySQL error
500111Failed to download the video from the specified URL.
500112Failed to download the audio from the specified URL.
500113Verification code expired or speaker ID invalid
500120验证码发送过于频繁,请稍后再试。
500200User does not exist.
500201Incorrect password.
500203Invalid verification code.
500205This username is already taken.
500212username/password/email/validate can't be empty
500213password over limit
500214Temporary or disposable email addresses are not supported.
500311the mail already exists
500802The specified API key does not exist.
701001Object detection failed.
701002Upload a photo with a clear subject like a person or an animal.
701007Network error. Please try again in a moment.
701009Invalid query. You can only query your own generated or uploaded content.
701024Invalid lip-sync speech speed
701025subtitle must be a boolean.
702000API webhook limit reached
702003The specified API webhook does not exist.
712008Request too fast. Please try again later.
修改于 2026-10-21 02:18:49
上一页
查询任务状态说明
下一页
错误详情
Built with