快速开始
几分钟内接入第一个模型请求
元曜星辰 用一把 API Key 和一个统一端点接入所有主流模型,并自动做格式转换,让任意工具调用任意模型。
选择接入方式
根据你需要的控制粒度,有三种方式:
| 方式 | 适合场景 |
|---|---|
| 直接调用 API | 需要完全控制,任意语言,无额外依赖 |
| OpenAI SDK | 已有 OpenAI SDK / 兼容工具,无缝替换 |
| Agent 工具 | Claude Code、Codex、Gemini CLI 等调用任意模型 |
基础地址
| 协议 | 基础地址 |
|---|---|
| OpenAI 兼容 | https://api.yyxchen.com/openai |
| Anthropic 兼容 | https://api.yyxchen.com/anthropic |
| Gemini 兼容 | https://api.yyxchen.com/gemini |
| 视频生成 | https://api.yyxchen.com/videos |
1. 获取 API Key
登录 控制台 → Keys → 创建 Key。
Key 只在创建时完整显示一次,请立即复制并妥善保存。
所有请求都通过 Authorization: Bearer YOUR_API_KEY 认证(也接受 x-api-key 头)。见 认证方式。
2. 发起第一个请求
把 YOUR_API_KEY 替换为你的 Key。
curl https://api.yyxchen.com/openai/chat/completions \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "auto", "messages": [{"role": "user", "content": "你好,请介绍一下你自己"}] }'可以用哪些模型?
用 "model": "auto" 让 元曜星辰 自动选择最优模型,也可以指定具体 slug,例如 gpt-5、claude-sonnet-5、gemini-2.5-flash。列出你账号可用的全部模型:
curl https://api.yyxchen.com/openai/models \ -H "Authorization: Bearer YOUR_API_KEY"流式输出
加 "stream": true 即可逐 token 接收 Server-Sent Events(SSE):
curl https://api.yyxchen.com/openai/chat/completions \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "auto", "stream": true, "messages": [{"role": "user", "content": "写一首短诗"}] }'错误处理
错误信息在 describe 字段,并带一个错误码,例如 4004(额度不足)或 4002(上游错误)。见 错误码表。
3. 接入你的应用
OpenAI SDK(无缝替换)
把 baseURL 指向 元曜星辰,其余代码保持不变。
import osfrom openai import OpenAIclient = OpenAI( base_url=f'https://api.yyxchen.com/openai', api_key="YOUR_API_KEY",)completion = client.chat.completions.create( model="auto", messages=[{"role": "user", "content": "你好"}],)print(completion.choices[0].message.content)Cursor、Windsurf、Aider、Continue 等 OpenAI 兼容工具同理。见 OpenAI SDK 兼容工具。
直接调用 API(完全控制)
不想引入依赖、需要完全掌控请求/响应时直接用 HTTP——见 OpenAI 兼容 API,以及 Anthropic 和 Gemini 兼容端点。
Agent 工具
让 AI 编程工具通过 元曜星辰 调用任意模型:
- Claude Code — 设置
ANTHROPIC_BASE_URL。 - Codex — 添加
model_providers。
格式转换自动完成,
视频生成
通过异步 /videos 端点,从文本或参考图生成视频。见 视频生成 教程。
下一步
完整端点列表与在线调试见 API 参考.