跳转到文档
文档
打开控制台
本页内容

获取生成报价

tong_generation_quote

提交操作前，获取与模型、输入和配置完全对应的报价。

POST/v1/tools/tong_generation_quote/operations

请求示例#

curl -X POST 'https://platform.tongai.io/v1/tools/tong_generation_quote/operations' \  -H "Authorization: Bearer $TONG_API_KEY" \  -H "Content-Type: application/json" \  -H "Idempotency-Key: 45be69f1-c266-4a09-a82c-bf3c6303eb03" \  -d '{  "input": {    "body": {      "operation": "TEXT_TO_IMAGE",      "model": "tong_ea55aff4f3b5c8aba3a35569",      "routingParameters": {        "ratio": "16:9"      }    }  }}'
配置
curl --version

权限#

为自己的账户使用服务器端 API 密钥，为各客户的账户使用 OAuth。切勿将密钥放入提示词或工具参数。

generation:writequotes:write

请求正文#

REST 请求将工具参数封装在 input 中。MCP 调用直接发送相同参数。

bodyobject必填
显示嵌套字段
operationstring必填

选择所选模型支持的工作流。

允许的值"TEXT_TO_IMAGE""IMAGE_EDIT""CHARACTER_RECREATE""CHARACTER_RECREATE_SPICY""TEXT_TO_VIDEO""IMAGE_TO_VIDEO""CHARACTER_TO_VIDEO""CHARACTER_TO_VIDEO_SPICY""FIRST_LAST_TO_VIDEO"
示例"TEXT_TO_IMAGE"
modelstring必填

从实时发现中选择公开的 Tong 模型 ID。

最小长度：1 个字符。

最大长度：100 个字符。

示例"tong_ea55aff4f3b5c8aba3a35569"
resolutionstring | null可选
允许的值"480p""720p""768p""1080p""2k""4k"
quantityinteger可选

最小值：1。

最大值：60。

durationSecondsinteger可选

最小值：1。

最大值：60。

inputAssetIdsstring[]可选

最多项目数：20。

characterProfileIdstring可选

24 位十六进制 ID。

annotationGuideboolean可选
routingParametersobject可选

使用此模型和工作流返回的设置。报价与提交时请保持设置一致。

显示嵌套字段
directorRequiredReferenceCountinteger可选

最小值：1。

最大值：20。

recreateReferenceRolesstring[]可选

最多项目数：20。

ratiostring可选
允许的值"21:9""16:9""4:3""1:1""3:4""9:16""adaptive"
示例"16:9"
generateAudioboolean可选
promptExtendboolean可选
seedinteger可选

最小值：-1。

最大值：2147483647。

negativePromptstring可选

最大长度：3000 个字符。

negativePromptModestring可选
允许的值"REPLACE"
referenceRequestobject可选
显示嵌套字段
ratiostring可选

最小长度：1 个字符。

最大长度：20 个字符。

generateAudioboolean可选
promptstring必填

描述您希望创作的结果。

最小长度：1 个字符。

最大长度：20000 个字符。

directionobject必填
显示嵌套字段
versionnumber必填
允许的值1
capabilityRevisionstring必填

最小长度：1 个字符。

最大长度：100 个字符。

keepVideoSoundboolean可选
seedinteger可选

最小值：0。

最大值：2147483647。

automaticShotsboolean可选
automaticDurationboolean可选
outputResolutionstring可选
允许的值"720p-SR""1080p-SR""1440p-SR"
bitratestring可选
允许的值"standard""high"
returnLastFrameboolean可选
documentUrlstring可选

格式：uri。

最大长度：2048 个字符。

subjectSequenceinteger可选

最小值：0。

最大值：999。

subjectsobject[]可选

最多项目数：6。

显示嵌套字段
idstring必填

使用带编号的主体标签，例如 Subject1。

namestring必填

最小长度：1 个字符。

最大长度：80 个字符。

descriptionstring可选

最大长度：500 个字符。

assetIdsstring[]必填

最少项目数：1。

最多项目数：4。

shotsobject[]可选

最少项目数：1。

最多项目数：6。

显示嵌套字段
idstring必填

最小长度：1 个字符。

最大长度：80 个字符。

promptstring必填

描述您希望创作的结果。

最小长度：1 个字符。

最大长度：1800 个字符。

durationSecondsinteger必填

最小值：1。

最大值：15。

referencesobject[]必填

使用满足所选模型参考能力要求的自有资产 ID。

最多项目数：120。

显示嵌套字段
idstring必填

最小长度：1 个字符。

最大长度：80 个字符。

assetIdstring必填

使用已授权账户所拥有的资产标识。

24 位十六进制 ID。

fieldstring必填

最小长度：1 个字符。

最大长度：80 个字符。

labelstring必填

使用带编号的引用标签，例如 Image1。

assetIdsstring[]必填

最多项目数：120。

filmSceneobject可选
显示嵌套字段
projectIdstring必填

使用已授权账户所拥有的项目标识。

24 位十六进制 ID。

shotIdstring必填

使用字母、数字、下划线或连字符。

最小长度：1 个字符。

最大长度：120 个字符。

revisioninteger必填

最小值：0。

最大值：9007199254740991。

filmReferenceobject可选
显示嵌套字段
projectIdstring必填

使用已授权账户所拥有的项目标识。

24 位十六进制 ID。

entityIdstring必填

使用字母、数字、下划线或连字符。

最小长度：1 个字符。

最大长度：120 个字符。

revisioninteger必填

最小值：0。

最大值：9007199254740991。

请求标头#

HTTP
Authorization: Bearer $TONG_API_KEYContent-Type: application/jsonIdempotency-Key: 45be69f1-c266-4a09-a82c-bf3c6303eb03

每项操作保留一个 UUID，超时或重试时重复使用。同一 UUID 对应不同输入会被拒绝。

响应字段#

请求被接受不代表生成已完成。请跟踪已保存的任务，直到输出就绪。

已接受表示请求已保存。读取操作以跟踪执行。

JSON
{  "id": "e8aa0a87-6cd9-42eb-975a-b72bf43218c8",  "tool": "tong_generation_quote",  "category": "generation",  "channel": "api",  "state": "queued",  "status": "accepted",  "stage": "admission",  "dispatch_status": "pending",  "created_at": "2026-10-22T09:00:00.000Z",  "updated_at": "2026-10-22T09:00:00.000Z",  "detail_expires_at": null,  "detail_expired": false,  "timing": {    "dispatch_started_at": null,    "acknowledged_at": null,    "completed_at": null,    "dispatch_acknowledgement_ms": null,    "end_to_end_ms": null  },  "review": null,  "result": null,  "error": null,  "billing": {    "status": "pending",    "usage_credits": "0.000000",    "wallet_debited_credits": "0.000000"  }}
idstring必填

已保存操作的唯一 ID。

UUID，例如 e8aa0a87-6cd9-42eb-975a-b72bf43218c8。

toolstring必填
categorystring必填
channelstring必填
允许的值"api""mcp"
statestring必填

已保存任务当前的执行状态。

允许的值"queued""running""waiting""needs_review""paused""reconciling""succeeded""failed""cancelled"
statusstring必填

跟踪操作时使用的总体状态。

允许的值"accepted""running""needs_review""paused""reconciling""succeeded""failed""cancelled"
stagestring必填

操作当前所处的阶段。

允许的值"admission""dispatch""review""generation""reconciliation""complete"
dispatch_statusstring必填

表示工具是否接受了请求。确认接受并不代表生成已完成。

允许的值"pending""unknown""acknowledged"
created_atstring必填

ISO 8601 日期和时间，例如 2026-10-22T09:00:00Z。

updated_atstring必填

ISO 8601 日期和时间，例如 2026-10-22T09:00:00Z。

detail_expires_atstring | null必填

已存储操作详情的到期时间。null 表示当前未设置到期时间。

ISO 8601 日期和时间，例如 2026-10-22T09:00:00Z。

detail_expiredboolean必填

已存储的操作详情是否已到期。

timingobject必填

用于跟踪此操作的时间戳和耗时。

显示嵌套字段
dispatch_started_atstring | null必填

ISO 8601 日期和时间，例如 2026-10-22T09:00:00Z。

acknowledged_atstring | null必填

ISO 8601 日期和时间，例如 2026-10-22T09:00:00Z。

completed_atstring | null必填

ISO 8601 日期和时间，例如 2026-10-22T09:00:00Z。

dispatch_acknowledgement_msnumber | null必填

最小值：0。

end_to_end_msnumber | null必填

最小值：0。

reviewJSON | null必填

操作需要人工输入时的审核信息；否则为 null。

resultJSON | null必填

此工具返回的输出，尚无输出时为 null。

errorobject | null必填

操作失败时的公开错误代码；否则为 null。

显示嵌套字段
codestring必填
billingobject必填

客户积分用量和钱包扣费。输出就绪与账单结算是独立状态。

显示嵌套字段
statusstring必填
允许的值"none""pending""settled""released""reconciling"
usage_creditsstring必填

保留六位小数的十进制字符串，例如 1.250000。

wallet_debited_creditsstring必填

保留六位小数的十进制字符串，例如 1.250000。

released_creditsstring可选

保留六位小数的十进制字符串，例如 1.250000。

refunded_creditsstring可选

保留六位小数的十进制字符串，例如 1.250000。

unfunded_creditsstring可选

保留六位小数的十进制字符串，例如 1.250000。

pending_creditsstring可选

保留六位小数的十进制字符串，例如 1.250000。

tokensobject可选
显示嵌套字段
inputnumber可选

最小值：0。

outputnumber可选

最小值：0。

cachednumber可选

最小值：0。

cache_writenumber可选

最小值：0。

componentsobject[]可选
显示嵌套字段
idstring可选
source_idstring必填
toolstring必填
modelstring | null必填
channelstring必填
允许的值"api""mcp"
credential_idstring必填
kindstring必填
允许的值"text_pool""reasoning""generation"
usage_creditsstring必填

保留六位小数的十进制字符串，例如 1.250000。

wallet_debited_creditsstring必填

保留六位小数的十进制字符串，例如 1.250000。

evidence_atstring可选

ISO 8601 日期和时间，例如 2026-10-22T09:00:00Z。

updated_atstring可选

ISO 8601 日期和时间，例如 2026-10-22T09:00:00Z。

quoteobject可选

报价可用时返回的配置、价格和提交值。

显示嵌套字段
idstring必填

UUID，例如 e8aa0a87-6cd9-42eb-975a-b72bf43218c8。

operation_idstring必填

UUID，例如 e8aa0a87-6cd9-42eb-975a-b72bf43218c8。

toolstring必填
operationstring | null必填
modelstring | null必填
configurationobject必填
submit_valuestring必填
submit_fieldstring必填
quoted_creditsstring | null必填

保留六位小数的十进制字符串，例如 1.250000。

expires_atstring | null必填

ISO 8601 日期和时间，例如 2026-10-22T09:00:00Z。

请求与日志请求被接受不代表生成已完成。请跟踪已保存的任务，直到输出就绪。积分与计费跟踪报价、实际用量及已结算积分。

MCP 调用#

JSON
{  "jsonrpc": "2.0",  "id": 1,  "method": "tools/call",  "params": {    "name": "tong_generation_quote",    "arguments": {      "body": {        "operation": "TEXT_TO_IMAGE",        "model": "tong_ea55aff4f3b5c8aba3a35569",        "routingParameters": {          "ratio": "16:9"        }      }    },    "_meta": {      "io.tongai/idempotency-key": "45be69f1-c266-4a09-a82c-bf3c6303eb03"    }  }}

REST 请求将工具参数封装在 input 中。MCP 调用直接发送相同参数。

响应

JSON
{  "jsonrpc": "2.0",  "id": 1,  "result": {    "structuredContent": {      "id": "e8aa0a87-6cd9-42eb-975a-b72bf43218c8",      "tool": "tong_generation_quote",      "category": "generation",      "channel": "mcp",      "state": "queued",      "status": "accepted",      "stage": "admission",      "dispatch_status": "pending",      "created_at": "2026-10-22T09:00:00.000Z",      "updated_at": "2026-10-22T09:00:00.000Z",      "detail_expires_at": null,      "detail_expired": false,      "timing": {        "dispatch_started_at": null,        "acknowledged_at": null,        "completed_at": null,        "dispatch_acknowledgement_ms": null,        "end_to_end_ms": null      },      "review": null,      "result": null,      "error": null,      "billing": {        "status": "pending",        "usage_credits": "0.000000",        "wallet_debited_credits": "0.000000"      }    },    "content": [      {        "type": "text",        "text": "{\"id\":\"e8aa0a87-6cd9-42eb-975a-b72bf43218c8\",\"tool\":\"tong_generation_quote\",\"category\":\"generation\",\"channel\":\"mcp\",\"state\":\"queued\",\"status\":\"accepted\",\"stage\":\"admission\",\"dispatch_status\":\"pending\",\"created_at\":\"2026-10-22T09:00:00.000Z\",\"updated_at\":\"2026-10-22T09:00:00.000Z\",\"detail_expires_at\":null,\"detail_expired\":false,\"timing\":{\"dispatch_started_at\":null,\"acknowledged_at\":null,\"completed_at\":null,\"dispatch_acknowledgement_ms\":null,\"end_to_end_ms\":null},\"review\":null,\"result\":null,\"error\":null,\"billing\":{\"status\":\"pending\",\"usage_credits\":\"0.000000\",\"wallet_debited_credits\":\"0.000000\"}}"      }    ]  }}

错误与限制#

HTTP错误恢复
400无效请求REQUEST_INVALID重试前请修正错误指出的字段。
401无效凭据CREDENTIAL_INVALID检查凭据、有效期以及是否已被撤销。
402积分不足INSUFFICIENT_CREDITS为凭据所属账户充值积分，然后继续已保存的任务。
403权限被拒绝SCOPE_REQUIRED使用具有所需权限且可访问所选资源的凭据。
404资源不可用RESOURCE_UNAVAILABLE检查资源 ID，并确认其属于已授权账户。
409操作意图冲突IDEMPOTENCY_CONFLICT仅为原始请求复用意图标识。不同操作请使用新的 UUID。
429已达速率限制RATE_LIMITED等待 Retry-After 指定的时间后再重试同一请求。
503暂时不可用DEPENDENCY_UNAVAILABLE等待 Retry-After 指定时间并使用同一意图重试。超时后检查已保存的操作。
错误与速率限制了解错误响应，安全重试并恢复失败的生成任务。幂等性每项操作保留一个 UUID，超时或重试时重复使用。同一 UUID 对应不同输入会被拒绝。
复用生成为此工作流的下一步准备自有源文件。提交生成使用 Tong 账户和积分提交已配置的操作，跟踪保存的操作直至完成。获取替代方案报价提交操作前，获取与模型、输入和配置完全对应的报价。生成替代方案使用 Tong 账户和积分提交已配置的操作，跟踪保存的操作直至完成。重试生成使用 Tong 账户和积分提交已配置的操作，跟踪保存的操作直至完成。获取增强提示词读取所选自有资源或当前工作流状态，不启动新的生成任务。