调用 Genesis API

使用 Genesis API 从应用调用模型。完成本页后，你将获取模型 ID，并通过 Chat Completions 获得一条文本回复。

1. 准备调用信息

准备以下信息：

需要的信息

如何取得

用途

Genesis API Base URL

https://token.moi.matrixorigin.cn/v1

指定 Genesis 服务地址

Genesis 访问凭据

在访问凭据中创建个人访问令牌，或创建具有 Genesis 权限的服务账号 API Key

认证请求身份

模型 ID

在下一步从模型广场复制或通过 API 查询

指定本次调用的模型

先将服务地址和凭据保存为环境变量：

export GENESIS_BASE_URL='https://token.moi.matrixorigin.cn/v1'
export GENESIS_ACCESS_TOKEN='<你的访问凭据>'

2. 获取模型 ID

在 Genesis 模型广场中打开模型详情并复制模型 ID。也可以使用以下 API 查询当前凭据可以调用的模型：

curl "$GENESIS_BASE_URL/models" \
  -H "Authorization: Bearer $GENESIS_ACCESS_TOKEN" \
  -H "Accept: application/json"

从响应中的模型列表选择支持文本对话的模型，并保存其 ID：

export MODEL_ID='<响应中的模型 ID>'

3. 调用示例

本示例使用 Chat Completions 和前两步准备的访问凭据、模型 ID 发送一条消息：

curl -X POST "$GENESIS_BASE_URL/chat/completions" \
  -H "Authorization: Bearer $GENESIS_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "'"$MODEL_ID"'",
    "messages": [
      {"role": "user", "content": "用一句话解释数据血缘。"}
    ],
    "max_tokens": 1024
  }'

响应中出现文本内容，表示本次请求已返回模型回复。保存响应中的请求 ID 和实际模型 ID，便于后续定位调用。

下一步

最后更新于