指南教程TTAPI API 快速入门

TTAPI API 快速入门:从密钥到首次请求

创建并保护密钥,选择模型和接口,发出首个 OpenAI 兼容请求,再处理响应及异步任务。

TTAPI约 5 分钟阅读
本文导读

你将了解

  • 创建并妥善保管 API 密钥
  • 找到模型页和正确接口
  • 发出聊天请求并区分同步与异步结果
要点

用一个小的服务端请求验证模型输出和用量。接入图像、视频或音乐时,请按对应文档匹配认证请求头、字段和结果查询方式。

创建密钥并存放在服务端

先到 TTAPI 控制台创建密钥,将它存进 TTAPI_KEY 等服务端环境变量。不要把密钥放到浏览器、公开仓库、截图或客户端日志。

同一账户密钥可按各接口使用,但请求头要按文档配置。聊天兼容接口用 Authorization,其他接口可能用 TT-API-KEY 或厂商兼容请求头。

  • 在控制台创建密钥
  • 仅保存在服务端环境变量
  • 按对应接口使用认证头
  • 疑似泄露后更换密钥

先选任务类型,再选模型和接口

明确要输出的是文本、图像、视频还是音乐。查看对应模型 ID、操作和文档,核实后再写接入代码。

示例用 gpt-5.6-sol 向 /v1/chat/completions 发非流式请求。可以在确认支持后更换 model。

  • 文本通常直接返回或通过流式传输
  • 图像请核对是 URL 还是编码图像
  • 许多视频、音乐接口先返回任务 ID
  • 添加可选字段前同时核对模型页与接口文档

发出第一个 TTAPI 请求

在服务端设置 TTAPI_KEY,用最少的参数验证鉴权、路由和响应解析。示例仅传模型 ID 和聊天字段,并设置 stream=false。

成功时通常在 choices 里看到助手消息,还会返回用量。验证后再把调用接进产品的后端。

发送非流式聊天请求
cURL
curl --request POST \
  --url 'https://api.ttapi.io/v1/chat/completions' \
  --header "Authorization: Bearer $TTAPI_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "gpt-5.6-sol",
  "messages": [
    {
      "role": "user",
      "content": "Return a three-item launch checklist for an AI feature."
    }
  ],
  "stream": false
}'

读取结果并区分错误

读取 choices[0].message.content,保留响应 ID、模型、结束原因和用量,以便排障和复核费用。

401 常见原因是密钥缺失或不正确,400 常见原因是请求体或模型值需修改。只在重试安全时对超时、限流或部分服务错误重试,达到上限后显示清晰错误状态。

  • 确认 HTTP 状态后再读取内容
  • 记请求 ID,不记录密钥
  • 保存模型和用量
  • 为不同故障提供清晰提示

加入图像、视频或音乐生成

部分接口直接返回素材,耗时的视频或音乐任务通常先给任务 ID,再通过查询或回调取得结果。

跳转前保存异步任务 ID,将提示词、模型、状态和结果放在同一记录。轮询需要间隔和次数限制,在成功、失败或超时时结束。

  • 提交成功即保存任务 ID
  • 区分任务已受理和已完成
  • 刷新后可恢复待完成任务
  • 自动发布前审核成品

上线前检查一个完整流程

先用一个模型、一个端点和可验收的小任务上线。设置超时和重试上限,提前校验输入,密钥留在服务端,设计可防止因重连或重复点击而重复付费的提交方式。

确认流程可跟踪、可恢复,再接更多模型。把模型和接口专有参数封装在后端。

  • 密钥保存在服务端
  • 校验请求并给出清晰错误
  • 设定超时和重试上限
  • 保存异步任务状态
  • 监控用量、用时和错误
  • 上线前核对价格与文档