Skip to content
Platform / Docs / Terra chat completion API
Sign up Console →

API Reference

Terra chat completion API

REQUEST terra-chat-api ID 54

Terra chat completion for text and image prompts. Returns choices and usage in the same response.

REQUEST https://xiaoapis.com/api/chat/terra
Get an API key Console / try it Open Markdown

Overview

  • 纯文本对话
  • 图片 URL 多模态
  • 同步返回
  • 按次计费

Use cases

  • 爆款标题创作
  • 口播文案改写
  • 图文理解问答
  • Agent 同步推理
Conventions
  • Gateway · https://xiaoapis.com
  • Auth · send key (query or JSON body, as this API specifies)
  • Response · JSON. Check the business code and the HTTP status, not only HTTP 200

Authentication

Send the platform API key (query parameter key or JSON field key, as this page specifies). Create one in API key management.

REQUEST https://xiaoapis.com/api/chat/terra
Content-Type: application/json

{
  "key": "YOUR_API_KEY"
}

Request example

https://xiaoapis.com/api/chat/terra?key=你的密钥

Details

接口说明：

Terra 对话补全接口。支持纯文字对话，也支持在 messages 中传入图片 URL 进行多模态提问。

返回统一结构 {code,msg,data}，对话结果在 data 内（含 choices / usage 等字段）。

请求方法：推荐 POST + application/json。

计费：每次成功调用扣除 5 点（可在后台调整 consume）；失败不扣费。

请求HEADER：

名称值
Content-Typeapplication/json

鉴权说明：

key 可放在 URL 查询参数、JSON Body，或 Authorization: Bearer <key>。

请求参数说明：

名称必填类型示例值说明
key是string你的密钥平台 API Key；也可放在 URL 或 Authorization Bearer
model否stringterra模型名称，本接口固定为 terra
stream否booleanfalse是否流式；当前仅支持 false
messages是array见下方示例对话消息列表，至少一条
messages[].role是stringusersystem / user / assistant / tool
messages[].content是string / array你好纯文本 string，或多模态 content 数组（text + image_url）
temperature否number0.7可选扩展参数
max_tokens否integer2048可选扩展参数

文字提问示例：

{"key":"你的密钥","model":"terra","stream":false,"messages":[{"role":"user","content":"你好"}]}

图片提问示例：

{"key":"你的密钥","model":"terra","stream":false,"messages":[{"role":"user","content":[{"type":"text","text":"这张图片内容是什么"},{"type":"image_url","image_url":{"url":"https://你的域名/demo.png"}}]}]}

返回参数说明：

名称类型说明
codeint状态码，200 表示成功
msgstring状态信息
dataobject补全结果
data.idstring补全 ID
data.modelstring实际模型，固定 terra
data.choicesarray候选回复列表
data.choices[].message.rolestring通常为 assistant
data.choices[].message.contentstring模型回复正文
data.choices[].finish_reasonstring结束原因，如 stop
data.usageobjecttoken 用量（prompt / completion / total）
data.power_costnumber本次扣除点数

Response example

{"code":200,"msg":"success","data":{"id":"1-2ede12b5-77cc-48f9-b1d0-7ae35ee8d444","object":"","created":1777897048,"model":"terra","choices":[{"index":0,"message":{"role":"assistant","content":"你好！请问有什么我可以帮您的吗？"},"finish_reason":"stop"}],"usage":{"prompt_tokens":2,"completion_tokens":20,"total_tokens":22},"power_cost":5}}

Error codes

HTTP / 业务码说明
200调用成功
400参数错误、请求被拒绝或 stream 不支持
401 / 403认证失败，请检查 key
500服务端异常

FAQ

什么是 Terra API？

Terra 是销豹开放的对话补全接口，支持 messages 文本与 image_url 多模态提问，同步返回助手回复与用量。

Terra 怎么调用？

POST /api/chat/terra，JSON 提交 key 与 messages 数组；当前仅支持 stream=false。

可以传图片吗？

可以。user content 使用数组，包含 type=text 与 type=image_url。

和 IP 视频封面有什么关系？

IP 视频封面内部会用同类能力提炼标题；若只需标题/文案而不出图，可直接调 Terra。

如何计费？

按次扣点（默认以接口文档与控制台为准），失败不扣费。

Full console doc (with the debugger):/doc/54