Skip to Content

123API 提供统一的 OpenAI 兼容网关,用于把文本、图像、视频、音频能力放到同一个接入层。对于已经使用 OpenAI SDK 的项目,接入重点通常只是 Base URL、API Key 和模型名。

Base URL

https://123api.co/v1

Authentication

所有请求都通过 Bearer Token 鉴权:

Authorization: Bearer YOUR_API_KEY

常见接口

能力路径说明
模型列表GET /models查看当前可用模型和接入能力
文本对话POST /chat/completions聊天、推理、代码生成、流式输出
图像生成POST /images/generations文生图和视觉素材生成
视频生成POST /videos任务型视频生成,通常为异步流程
音频合成POST /audio/speech文本转语音
语音转写POST /audio/transcriptions音频识别与转写

接入建议

先同步模型列表

优先调用 GET /v1/models,再决定文档展示、默认模型和业务侧兜底逻辑。

先做最小可用验证

建议先从聊天接口开始,再逐步验证图片、视频、音频场景。

注意异步任务

视频等重型接口通常不是立即返回最终结果,建议保存任务 ID 并在业务侧继续跟踪。

把错误分类处理

鉴权、限流、参数错误和上游异常最好分别埋点和重试,方便排查。

实际可用模型、参数、价格与速率限制,请以控制台和接口返回为准。