关于
欢迎使用 GetToken API，轻松调用 GetToken 标准模型API。
开始使用
注册用户
先注册成为GetToken网站的用户，并充值钱包。标准模型API仅支持企业级 API Key。
获取您的 API Key
GetToken 为每位用户自动生成一个独特的 32 位 API KEY。
请妥善保存您的 API KEY，不要外泄，后续步骤将依赖此密钥进行操作。
提交请求
适用于生产环境的高质量文生图任务，强调细节控制和稳定出图。
提交 API 请求。GetToken API 已为您处理 API Key，您只需提交请求即可。
请求示例
curl
请求参数说明
| 参数说明 | 类型 | 必填/可选 | AI 应用程序生成的结果。 |
|---|
响应示例
json
{
"taskId": "2013508786110730241",
"status": "RUNNING",
"errorCode": "",
"errorMessage": "",
"results": null,
"clientId": "f828b9af25161bc066ef152db7b29ccc",
"promptTips": ""
}
响应字段说明
| 参数说明 | 类型 | AI 应用程序生成的结果。 |
|---|
查询结果（轮询）
提交任务后，请使用返回的 taskId 调用 query 接口轮询任务状态，直到进入终态（SUCCESS 或 FAILED）。
请求示例
curl
curl --location --request POST 'https://nb.gettoken.cn/openapi/v1/query' \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${API_SERVICE_API_KEY}" \
--data-raw '{
"taskId": "${API_SERVICE_TASK_ID}"
}'
响应示例
json
{
"taskId": "2013508786110730241",
"status": "SUCCESS",
"errorCode": "",
"errorMessage": "",
"failedReason": {},
"results": [
{
"url": "https://nb.gettoken.cn/demo/output/ComfyUI_00001.png",
"outputType": "png",
"text": null
}
],
"clientId": "",
"promptTips": ""
}
响应字段说明
| 参数说明 | 类型 | AI 应用程序生成的结果。 |
|---|
Webhook 回调（可选）
提交任务时可添加 webhookUrl。任务进入终态（SUCCESS / FAILED / TIMEOUT / CANCELED）后，服务端会向该 URL 发起 POST 回调。
回调 Header：Content-Type: application/json、X-Task-Id: <taskId>。如配置了回调签名密钥，还会带 X-Callback-Signature: sha256=<hex>。
回调体示例
json
{
"taskId": "2013508786110730241",
"status": "SUCCESS",
"errorCode": "",
"errorMessage": "",
"results": [
{
"url": "https://nb.gettoken.cn/demo/output/veo31_00001.mp4",
"outputType": "mp4",
"text": null
}
],
"clientId": "f828b9af25161bc066ef152db7b29ccc",
"promptTips": "",
"model": "google/veo-3.1-fast",
"metadata": {},
"finishedAt": "2026-03-17T10:21:30Z"
}
文件上传
资源文件（如 imageUrls）参数支持传入文件 URL 或 Base64 Data URI。
当前文档页对应的 wudi-api 网关对单次 JSON 请求体限制为 10MB（包含 imageUrls、prompt 等全部字段）。
公共 URL
直接传递可公开访问的 URL：
json
{
"imageUrls": [
"https://nb.gettoken.cn/image.png"
]
}
Base64 data URI
以 Base64 格式嵌入图片：
json
{
"imageUrls": [
"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..."
]
}
GetToken 上传接口
上传本地文件以获取可访问 URL：
curl
curl --location --request POST 'https://nb.gettoken.cn/openapi/v1/media/upload/binary' \
--header "Authorization: Bearer ${API_SERVICE_API_KEY}" \
--form 'file=@/path/to/image.png'
json
{
"code": 0,
"message": "success",
"data": {
"type": "image",
"download_url": "https://nb.gettoken.cn/openapi/xxxx.png",
"fileName": "openapi/xxxx.png",
"size": "3490"
}
}