TRAINKR AI Docs
    • 前言(必读)
    • OpenAI SDK
    • 快速开始
    • 高并发示例
    • 错误码排障
    • 基础接口
      • Gemini(原生)
        • Gemini generateContent(非流式)
        • Gemini streamGenerateContent(流式)
      • 聊天接口(通用)
        POST
      • Claude (原生格式)
        POST
      • responses接口(原生)
        POST
      • 创建嵌入
        POST
    • 多模态接口
      • 可灵
        • OMNI video
        • 任务:文生视频
        • 任务:图生视频
        • 查询
        • 人脸识别
        • 对口型
        • 通用查询
        • motion-control
        • custom-elements
        • 自定义音色
        • 查询主体
        • 查询音色
        • 查询音色列表
        • 查询-动作控制
        • 查询文生视频
        • omni-image
        • 查询omni-images
        • 创建主体(新)
        • 查询主体 -单个
        • 查询主体 列表
        • OMNI video Copy
      • Flux
        • /v1/flux-2-pro
        • 查询flux
      • 阿里万相
        • 图生视频
        • 查询任务
      • Video通用接口(持续开发中)
        • Veo视频生成
        • 可灵视频生成
        • 视频生成结果查询
      • sora(原生)
        • 文生视频
        • 查询内容接口
        • 查询详情接口
      • 图片生成(image)
        • OpenAi
          • 图像生成 dall-e-2、dall-e-3
          • 图像生成 gpt-image
          • 图像编辑 gpt-image
        • Gemini
          • nano-banana参考尺寸
          • 图像生成 nano-banana
          • 图像编辑 nano-banana
        • 即梦AI
          • 即梦4.0-图片生成
          • 既梦4.0-图片编辑
          • 即梦3.0-图片生成
          • 既梦3.0-图片编辑
        • Qwen
          • 图像生成
          • 图像编辑
        • Grok
          • 图像生成
    • 系统接口
      • 查询令牌用量
        GET
      • 查询令牌限额
        GET
      • 查询账户信息
        GET
    • Agent接入
      • Claude Code
      • Codex
      • Gemini CLI
      • OpenClaw
      • OpenCode
    • 数据模型
      • Schemas
        • Veo3VideoGenerationRequest
        • VideoGenerationRequest
        • VeoVideoGenerationRequest
        • Veo3Instance
        • Veo3Image
        • VeoMediaObject
        • Veo3Parameters
        • VeoParameters
        • JimengVideoGenerationRequest
        • JimengContent
        • JimengImage
        • JimengImageUrl
        • JimengParameters
        • FluxImageGenerationRequest
      • GenerateContentRequest
      • Content
      • Part
      • GenerationConfig
      • SafetySetting
      • GenerateContentResponse

    00-前言(必读)

    模型兼容#

    我们的API,完全兼容OpenAI接口协议,支持无缝对接各种支持OpenAI接口的应用。
    注意: 所有聊天模型(包括非OpenAI模型)都支持OpenAI官方库,请求url和格式请都遵循OpenAI的请求方式。
    参考:官方开发文档
    聊天接口类型接口地址接口说明
    OpenAi通用格式/v1/chat/completions可请求本站所有chat类型模型(包括非OpenAI模型)
    OpenAi新的格式/v1/responses仅部分OpenAI新模型支持,建议使用上方通用格式
    Claude原生格式/v1/messages只能请求支持claude原生格式的模型,其他模型请求将:无可用
    Gemini原生格式/v1beta/models/...只能请求Gemini模型,其他模型请求将:无可用,参数统一使用小驼峰命名,例如imageSize(正确)、image_size(错误)

    身份认证#

    所有 API 请求都应在 HTTP Header 请求头中包含您的API密钥(令牌KEY)如下所示:
    数据格式Header传参
    OpenAI通用格式Authorization: Bearer sk-xxx
    Claude原生格式x-api-key: sk-xxx
    anthropic-version: 2023-06-01
    Gemini原生格式x-goog-api-key: sk-xxx

    API地址#

    请在我们的API网站 -> 控制台 中查看当前站点的API地址。
    切勿绑错API地址和KEY 以免造成请求失败而无法排查原因。

    统一域名(强提醒)#

    所有示例与SDK接入统一使用:https://maas.trainkr.cloud
    OpenAI兼容:https://maas.trainkr.cloud/v1
    Claude原生:https://maas.trainkr.cloud/v1/messages
    Gemini原生:https://maas.trainkr.cloud/v1beta/models/...
    不要混用其他站点或历史域名,否则容易出现鉴权成功但请求模型失败的问题。

    建议阅读顺序#

    1.
    先读本文(协议与认证)
    2.
    再看 OpenAI 官方 SDK 教程
    3.
    先看快速开始(3分钟)
    4.
    再看错误码与排障
    5.
    需要压测时阅读高并发示例
    6.
    使用特定工具时再看 Claude/Codex/Gemini/OpenClaw/OpenCode 教程

    参考资料#

    OpenAI官方开发文档
    Claude官方开发文档-需翻墙
    Gemini官方开发文档
    修改于 2026-03-29 14:06:31
    下一页
    OpenAI SDK
    Built with