元曜星辰 Docs

快速开始

几分钟内接入第一个模型请求

元曜星辰 用一把 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 参考.

本页目录