API 接入 · Python
用 Python 接入 OpenAI 兼容 API。
兼容客户端通常需要设置 API Base URL 和私有 API 密钥。模型名称请以当前模型目录为准，不要照抄旧代码中的模型 ID。
1. 获取当前连接信息
仅在服务面向你所在地区开放时登录。请在自己的控制台创建 API 密钥，并从当前模型目录复制模型 ID。模型名称和接口格式支持情况可能变化。
- 公开接入页展示的 API Base URL：
https://aimyria.com/v1。 - API 密钥：创建并使用属于你本人账户的密钥。
- 模型 ID：复制当前目录里与你要调用的模型完全一致的 ID。
2. 把密钥放在源代码之外
通过终端环境变量或密钥管理器保存密钥。不要把密钥写入代码仓库、浏览器端应用、手机应用、共享笔记、截图或前端构建产物。
macOS / Linux 终端
export AIMYRIA_API_KEY="YOUR_OWN_API_KEY"
export AIMYRIA_MODEL="COPY_THE_EXACT_ID_FROM_THE_CATALOG"PowerShell
$env:AIMYRIA_API_KEY = "YOUR_OWN_API_KEY"
$env:AIMYRIA_MODEL = "COPY_THE_EXACT_ID_FROM_THE_CATALOG"3. 使用 OpenAI Python SDK 发起请求
在项目环境中安装 SDK 后运行示例。只需把环境变量设置为你自己的密钥和目录中当前展示的模型 ID。
Python
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["AIMYRIA_API_KEY"],
base_url="https://aimyria.com/v1",
)
response = client.chat.completions.create(
model=os.environ["AIMYRIA_MODEL"],
messages=[{"role": "user", "content": "用一句话写一段问候。"}],
)
print(response.choices[0].message.content)4. 也可以使用 cURL
请在服务端终端发出请求，并尽量避免把密钥写入共享的命令历史。
curl https://aimyria.com/v1/chat/completions \
-H "Authorization: Bearer $AIMYRIA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "'"$AIMYRIA_MODEL"'",
"messages": [{"role": "user", "content": "用一句话写一段问候。"}]
}'常见问题排查
- 401：检查密钥是否完整、有效并属于自己的账户。不要把密钥发到公开工单或聊天中。
- 模型或接口错误：从实时目录重新复制模型 ID，并确认该模型支持当前所选接口格式。
- 请求成功但输出不同：模型表现可能不同；请查看模型当前说明和上游使用规则。
按允许范围使用密钥和服务
请妥善保护密钥，并遵守服务条款及上游模型政策。公开条款禁止未经书面授权共享访问权限或再分发服务。不要把密钥放进会向最终用户公开的应用中。
常见疑问
这个接口可以使用任意模型 ID 吗？
不可以。请使用当前目录中的准确 ID，并确认该模型支持所选接口格式。
OpenAI 兼容是否表示服务由 OpenAI 运营？
不是。“兼容”指接口格式。Aimyria 是独立服务，不是第三方模型的官方运营方。
所有国家和地区都可以注册吗？
不可以。服务受当前支持地区政策限制。请在注册或购买前核对完整地区列表。