Skip to main content

架构概览

Wizzx 所有公开模型共用同一个生产网关（https://api.wizzx.ai）、同一个 API Key 与同一套异步任务生命周期：
  1. 发现模型与实时价格：调用 GET /pricing（支持 ?locale=zh）或 GET /v1/models，无需鉴权。
  2. 提交生成任务：向 POST /api/v1/task/submit/{model_key}（Suno 音乐动作为 POST /api/v1/music/{action}）发送 JSON，支持可选 Idempotency-Key 防重请求头。
  3. 轮询任务结果：请求 GET /api/v1/task/{task_id}（或 POST /api/v1/task/status），直到 status 进入 SUCCEEDED 或 FAILED。
新注册账号登录后自动获赠 200 免费积分（$0.20 USD），换算比例固定为 1,000 积分 = 1.00 USD。可随时前往 API 密钥控制台 创建或轮换密钥。

认证方式

在所有需要鉴权的请求中添加标准 Authorization: Bearer 请求头：
请将密钥保存在服务端环境变量（如 WIZZX_API_KEY）中，切勿暴露在前端打包代码或版本库中。公开目录接口（GET /pricing、GET /v1/models、GET /pricing/metrics）无需鉴权且内置浏览器 CORS 支持。

60 秒快速开始

1. 提交图像生成任务

网关会先完成参数校验并原子预留积分，随后返回任务 ID：

2. 根据 Task ID 查询结果

当 data.status 变为 SUCCEEDED 时，从 data.result_urls 读取生成文件地址（Suno 音乐任务同时返回结构化 data.result）。若任务在生成阶段失败，预留积分会自动退回，data.credits_deducted 返回 0。

服务发现与 AI 智能体入口

在 AI 智能体中生成媒体

复制可直接用于 Claude Code、Codex 或项目级 Skill 的确定性调用契约。

错误码与幂等保护

处理 402 余额差额、409 幂等冲突锁与 429 Retry-After 退避策略。