开发者平台

使用统一接口完成模型接入

AITransX 提供对话、生图与语音合成接口。使用同一个 API Key 调用模型，并在控制台管理用量、日志和访问限制。

在线体验

在浏览器中体验模型

直接测试聊天、生图和语音效果，再用下方示例接入 API。

AI 聊天生成图片语音合成

立即体验模型登录后会自动进入模型使用页

接入准备

使用一个 base_url 和一个 API Key

配置统一 API 地址和 Bearer Key，然后选择稳定的模型 ID，即可将请求接入 AITransX 路由层。

接口基础地址

把这里设置为 OpenAI SDK 的 base_url；长耗时生图建议使用直连 API 域名，避免代理等待超时。

OpenAI SDK

base_url = "https://api.aitransx.com/v1"

认证

所有私有请求都必须携带 API Key。你可以在控制台创建和管理 Key。

HTTP

Authorization: Bearer aitx-your-key
Content-Type: application/json

模型 ID

下面仅展示几种常用模型 ID 写法；实际可用型号以 GET /v1/models 为准。

Models

GET https://api.aitransx.com/v1/models

model = "auto"
model = "gpt-5.6-sol"
model = "deepseek@deepseek-v4-pro"

核心接口

对话、生图和语音接口

聊天补全用于文本和多模态对话；生图接口返回图片；语音接口把文本合成音频。

POST /v1/chat/completions

聊天补全接口

向 /v1/chat/completions 发送 OpenAI 兼容请求。示例使用 gpt-5.6-sol，并支持通过 stream: true 开启流式输出。

cURL

curl https://api.aitransx.com/v1/chat/completions \
  -H "Authorization: Bearer aitx-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-sol",
    "messages": [{"role": "user", "content": "Hello"}],
    "stream": false
  }'

Python SDK

Python

from openai import OpenAI

client = OpenAI(
    api_key="aitx-your-key",
    base_url="https://api.aitransx.com/v1",
)

completion = client.chat.completions.create(
    model="gpt-5.6-sol",
    messages=[
        {"role": "user", "content": "Hello"},
    ],
    stream=False,
)

print(completion.choices[0].message.content)

POST /v1/images/generations

文字生图接口

向 /v1/images/generations 发送模型 ID 和提示词，即可根据文字生成图片。Python SDK 示例会把返回的 b64_json 保存为 out.png。

cURL

curl https://api.aitransx.com/v1/images/generations \
  -H "Authorization: Bearer aitx-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "a premium product render of a white ceramic cup",
    "size": "1024x1024",
    "response_format": "b64_json"
  }'

Python SDK

Python

import base64
from openai import OpenAI

client = OpenAI(
    api_key="aitx-your-key",
    base_url="https://api.aitransx.com/v1",
    timeout=140,
)

result = client.images.generate(
    model="gpt-image-2",
    prompt="a premium product render of a white ceramic cup",
    size="1024x1024",
    response_format="b64_json",
)

with open("out.png", "wb") as f:
    f.write(base64.b64decode(result.data[0].b64_json))

POST /v1/images/generations

参考图生图接口

同样请求 /v1/images/generations，通过 input_references 传入参考图，进行图片编辑或参考图生成。cURL 示例中的图片网址需替换为可公开访问的网址；Python SDK 示例读取本地 reference.png，结果保存为 edited.png。SDK 使用 extra_body 传入 input_references。

请选择支持参考图的模型。支持 PNG、JPEG 和 WebP，本地图片编码为 base64 后传入，单图原始大小不超过 4 MB。参考图按数组顺序传入，最多 4 张，部分模型的上限更低。

cURL

curl https://api.aitransx.com/v1/images/generations \
  -H "Authorization: Bearer aitx-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "Keep the cup shape and change its color to blue",
    "size": "1024x1024",
    "response_format": "b64_json",
    "input_references": [
      {
        "type": "image_url",
        "image_url": {"url": "https://example.com/reference.png"}
      }
    ]
  }'

Python SDK

Python

import base64
from pathlib import Path
from openai import OpenAI

client = OpenAI(
    api_key="aitx-your-key",
    base_url="https://api.aitransx.com/v1",
    timeout=140,
)

reference_bytes = Path("reference.png").read_bytes()
reference_b64 = base64.b64encode(reference_bytes).decode("ascii")
reference_url = "data:image/png;base64," + reference_b64

result = client.images.generate(
    model="gpt-image-2",
    prompt="Keep the cup shape and change its color to blue",
    size="1024x1024",
    response_format="b64_json",
    extra_body={
        "input_references": [
            {
                "type": "image_url",
                "image_url": {"url": reference_url},
            },
        ],
    },
)

with open("edited.png", "wb") as f:
    f.write(base64.b64decode(result.data[0].b64_json))

POST /v1/audio/speech

语音合成接口

向 /v1/audio/speech 发送文本、音色和音频格式，成功后直接返回可保存或播放的音频文件。语音请求按对应模型的字符价格计费。

cURL

curl https://api.aitransx.com/v1/audio/speech \
  -H "Authorization: Bearer aitx-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen/qwen-audio-3.0-tts-flash",
    "input": "Hello from AITransX",
    "voice": "longanhuan_v3.6",
    "response_format": "mp3"
  }' \
  --output speech.mp3

Python SDK

Python

from openai import OpenAI

client = OpenAI(
    api_key="aitx-your-key",
    base_url="https://api.aitransx.com/v1",
)

with client.audio.speech.with_streaming_response.create(
    model="qwen/qwen-audio-3.0-tts-flash",
    input="Hello from AITransX",
    voice="longanhuan_v3.6",
    response_format="mp3",
) as response:
    response.stream_to_file("speech.mp3")

联网搜索与网页读取

在聊天输入框开启“联网搜索”，即可让当前模型结合网页资料回答，并通过数字引用查看来源。支持自动生成检索词，也可在搜索设置中指定关键词、来源网站和规划模型。开发者可使用自己的 AITransX API Key 调用下方 Search / Fetch 接口，获取网页资料。

POST /v1/tools/search

DeepSeek Search

query 为 1–128 个字符；count 可选，范围 1–50，默认 10；need_content 控制是否附带正文。还可传 ori_question（原始问题）与 localization（IP 地址）。 DeepSeek 官方工具文档

cURL

curl https://api.aitransx.com/v1/tools/search \
  -H "Authorization: Bearer aitx-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "DeepSeek API search",
    "count": 5,
    "need_content": true
  }'

POST /v1/tools/fetch

DeepSeek Fetch

url 为一个 HTTP 或 HTTPS 网页地址。Search 返回 results 数组；Fetch 返回 title 与 content，可作为后续模型调用的参考资料。

cURL

curl https://api.aitransx.com/v1/tools/fetch \
  -H "Authorization: Bearer aitx-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://api-docs.deepseek.com/"
  }'

按次费用

明确不需联网的简单任务会直接回答，仅产生聊天模型费用。需要联网时，关键词规划、网页搜索、网页读取和模型回答按实际发生的用量分别计费。每轮最多执行 3 次搜索，按需读取最多 2 个网页正文。手动关键词和直接读取指定链接会跳过规划。搜索与读取按成功返回非空结果的请求次数计费，失败、超时和空结果不收该次工具费。停止或后续步骤失败时，已完成费用仍保留；单价见价格表，实际费用见请求日志。价格

使用与可用性

联网搜索由平台提供，可搭配所有已开通的聊天模型。用户只需在聊天输入框开启，无需额外配置。暂不可用时，可关闭联网搜索继续普通聊天，或联系支持。

联系支持

运行说明

限额、日志和常见响应

生产接入前建议设置 Key 限额，查看元数据日志，并在客户端处理标准 JSON 错误响应。

费用和流量控制

接入生产流量前，建议为每个 Key 配置限额，并在控制台查看请求日志。

请求前余额检查每个 Key 月度词元上限每个 Key RPS 限制请求日志可导出

日志和隐私

控制台日志只保存模型、服务商、请求用量、费用、延迟和状态等运维元数据，不把 prompt、response 或音频正文写入磁盘。

常见响应

错误响应使用常见 HTTP 状态码，并返回 JSON 错误信息，方便客户端处理。

状态码	含义	建议处理
`400` `content_policy_violation`	图像生成请求未通过内容安全审核，未产生费用	调整提示词或参考图片后重新提交。
`401`	API Key 缺失、无效或已撤销	创建新 Key，或检查 Bearer token。
`402`	余额不足，或当前账户尚未启用所请求的模型范围	补充账户余额以启用完整模型范围，或选择当前可用模型。
`429`	触发限速或并发限制	使用退避重试，或提高该 Key 的限制。
`503`	请求模型没有健康的上游路由	检查 /v1/models，更换模型 ID，或联系支持。

公开端点

端点	用途	认证
`GET /v1/models`	列出可路由模型 ID	无需 Key
`GET /api/pricing`	列出公开模型价格	无需 Key
`POST /v1/chat/completions`	创建聊天补全	Bearer Key
`POST /v1/images/generations`	创建生图请求	Bearer Key
`POST /v1/audio/speech`	将文本生成语音	Bearer Key
`POST /v1/tools/search`	联网搜索（按次计费）	Bearer Key
`POST /v1/tools/fetch`	网页正文读取（按次计费）	Bearer Key
`GET /healthz`	服务健康检查	无需 Key