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

GET /v1/models

读取所选自有资源或当前工作流状态,不启动新的生成任务。

请求示例#

curl 'https://platform.tongai.io/v1/models' \  -H "Authorization: Bearer $TONG_API_KEY"
配置
curl --version

身份验证#

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

catalog:read

参数#

modelstring可选

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

operationstring可选

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

请求正文#

此端点没有请求正文。

响应架构#

JSON
{  "workflows": []}

HTTP 200

application/json
text_modelsobject[]可选
显示嵌套字段
idstring必填
namestring必填
context_tokensinteger必填

最大值:9007199254740991。

max_output_tokensinteger必填

最大值:9007199254740991。

unitstring必填
允许的值"THOUSAND_TOKENS"
input_creditsstring必填

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

output_creditsstring必填

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

cached_input_creditsstring必填

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

cache_write_creditsstring必填

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

pricingstring必填
允许的值"display_maximum"
requires_exact_quoteboolean必填
允许的值true
workflowsobject[]必填

最多项目数:10000。

显示嵌套字段
operationstring必填
modelstring必填
namestring必填
model_namestring必填
resolutionstring | null必填
unitstring必填
creditsstring | null必填

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

base_creditsstring | null必填

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

requires_exact_quoteboolean可选

默认值:false。

pricingstring可选
允许的值"configuration_quote""display_rate"

默认值:"display_rate"。

discount_percentnumber必填

最小值:0。

最大值:100。

错误与限制#

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 指定时间并使用同一意图重试。超时后检查已保存的操作。