运维

生产环境检查清单

为可靠的生成集成准备成本、任务、Webhook 和错误恢复。

阅读约 1 分钟2 个章节

生产准备从 API 调用之前开始：校验输入、估算价格、保存 taskId，并异步处理结果。

实操要点

按优先目标选择模型——速度、还原度、分辨率或控制能力——并保存每次结果的参数和版本。 the model selected for the task — Production checklist.

每次尝试只改一件事。好的输出应保留为参考图，它是下一轮迭代最可靠的起点。

将 finished 和 failed 视为终态。使用 polling 或 webhook，在服务器保存原始错误，并向用户展示安全的信息。

提示词与 API 示例

json

{
  "model": "veo3.1-fast",
  "input": { "prompt": "…", "aspectRatio": "16:9" },
  "webhook": "https://example.com/hooks/api-stock/8f2c1e9a-b40d-4c77-9a1e-secret"
}

json

{
  "code": 402,
  "error": {
    "message": "Insufficient balance. Please top up your account",
    "type": "PaymentRequired",
    "code": "insufficient_balance"
  }
}

  curl https://api.api-stock.com/api/v1/user/me \
    -H "Authorization: Bearer sk-your-key"

json

  {
    "code": 200,
    "data": {
      "id": "019c1f70-2b44-70d3-9c22-6b7ad0f41e18",
      "balance": 48250,
      "createdAt": "2026-01-14T09:03:11.000Z"
    }
  }

curl https://api.api-stock.com/api/v1/catalog

curl https://api.api-stock.com/api/v1/catalog/veo3.1-fast

用你自己的密钥跑一遍

本指南中的所有模型都已上架 API Stock 目录——一个 API 密钥、一个预付余额，无需在各家供应商分别注册。

浏览目录 API 参考

继续阅读

实操要点

按优先目标选择模型——速度、还原度、分辨率或控制能力——并保存每次结果的参数和版本。 the model selected for the task — Production checklist.

每次尝试只改一件事。好的输出应保留为参考图，它是下一轮迭代最可靠的起点。

将 finished 和 failed 视为终态。使用 polling 或 webhook，在服务器保存原始错误，并向用户展示安全的信息。

提示词与 API 示例

json

{
  "model": "veo3.1-fast",
  "input": { "prompt": "…", "aspectRatio": "16:9" },
  "webhook": "https://example.com/hooks/api-stock/8f2c1e9a-b40d-4c77-9a1e-secret"
}

json

{
  "code": 402,
  "error": {
    "message": "Insufficient balance. Please top up your account",
    "type": "PaymentRequired",
    "code": "insufficient_balance"
  }
}

  curl https://api.api-stock.com/api/v1/user/me \
    -H "Authorization: Bearer sk-your-key"

json

  {
    "code": 200,
    "data": {
      "id": "019c1f70-2b44-70d3-9c22-6b7ad0f41e18",
      "balance": 48250,
      "createdAt": "2026-01-14T09:03:11.000Z"
    }
  }

curl https://api.api-stock.com/api/v1/catalog

curl https://api.api-stock.com/api/v1/catalog/veo3.1-fast