`POST /v1/conversations`

使用此 HTTP 端点文档列出的请求字段和权限。

请求示例#

curl -X POST 'https://platform.tongai.io/v1/conversations' \  -H "Authorization: Bearer $TONG_API_KEY" \  -H "Content-Type: application/json" \  -H "Idempotency-Key: 45be69f1-c266-4a09-a82c-bf3c6303eb03" \  -d '{  "entrypoint": "assistant",  "mode": "guided"}'

配置

curl --version

身份验证#

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

assistant:runcredits:spend

参数#

Idempotency-Keystring必填

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

请求正文#

application/json

entrypointstring必填

允许的值"assistant""filmmaker"

modestring必填

引导模式会暂停以在 Tong 中进行人工审核，自动模式会继续运行。两者都随工作进度计费，积分不足时暂停。

允许的值"guided""automatic"

titlestring可选

最大长度：100 个字符。

project_idstring可选

24 位十六进制 ID。

model_preferencesobject可选

显示嵌套字段

imagestring | null必填

使用字母、数字、下划线、句点、冒号、斜杠或连字符。

最小长度：1 个字符。

最大长度：150 个字符。

videostring | null必填

使用字母、数字、下划线、句点、冒号、斜杠或连字符。

最小长度：1 个字符。

最大长度：150 个字符。

sourceobject可选

显示嵌套字段

kindstring必填

允许的值"director""text"

idstring必填

24 位十六进制 ID。

响应架构#

响应

JSON

{}

`HTTP 201`

application/json

object

错误与限制#

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

身份验证API 密钥从密钥所属账户扣费。OAuth 让每位连接用户使用自己的积分。错误与速率限制了解错误响应，安全重试并恢复失败的生成任务。请求与日志请求被接受不代表生成已完成。请跟踪已保存的任务，直到输出就绪。