Skip to content

New API 接入 ​

本文提供基础渠道配置和连通性测试。正式使用时,还需要根据自己的 New API 版本和业务完成价格设置、模型映射、分组与模型开放等配置。

配置渠道 ​

在 New API 渠道管理中新增渠道:

表格较宽时,可左右滑动查看完整内容。

配置项填写内容
类型OpenAI
名称自定义,例如 星辰 AI
密钥在 星辰 AI 官网创建的平台 API Key
API 地址https://api.video.aistarslab.com/openai

点击“获取模型列表”,拉取当前可用模型并保存渠道。

New API 渠道类型、API 地址及模型配置示例

截图中的模型 ID 仅作示例,请使用实际获取的完整 ID,不要照抄历史线路或模型。

添加测试模型 ​

  1. 在渠道的自定义模型名称中填写 test:test-video,添加并保存。
  2. 根据自己的 New API 配置,允许相应分组或令牌使用该模型。
  3. 完成连通性测试后,删除不再需要对外提供的测试模型。
在 New API 中添加 test:test-video 自定义模型

测试模型不会真实生成视频,也不会扣减 星辰 AI 账号的生成积分,仅返回测试数据。New API 自身的计费和权限由你配置。

请求自己的 New API 服务 ​

下面保留原接入教程的请求示例。NEW_API_BASE_URL 是你部署的 New API 服务地址,NEW_API_TOKEN 是该服务签发的调用令牌,不是直接访问 星辰 AI 的地址和密钥。

此示例使用 /v1/video/generations,是否适用取决于你的 New API 版本及其视频接口实现,请以所用版本的接口说明为准。

bash
export NEW_API_BASE_URL='https://your-new-api.example.com'
export NEW_API_TOKEN='YOUR_NEW_API_TOKEN'

curl "$NEW_API_BASE_URL/v1/video/generations" \
  -H "Authorization: Bearer $NEW_API_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{
    "model": "test:test-video",
    "prompt": "海边日落,镜头缓慢向前推进",
    "duration": 4,
    "width": 1280,
    "height": 720,
    "n": 1
  }'

直接测试 星辰 AI 上游 ​

需要区分渠道问题与上游连通性问题时,可在自己的终端直接调用平台兼容接口。这里使用 星辰 AI 的 API Key 和完整请求地址。

bash
export AISTARSLAB_API_KEY='YOUR_AISTARSLAB_API_KEY'

curl 'https://api.video.aistarslab.com/openai/v1/videos' \
  -H "Authorization: Bearer $AISTARSLAB_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
    "model": "test:test-video",
    "prompt": "测试视频生成接口",
    "seconds": "5",
    "size": "16:9",
    "n": 1
  }'

创建和查询的完整响应结构参见 OpenAI 兼容接口。本教程覆盖基础接入,New API 的专项配置和版本差异请参考对应项目文档。

星辰 AI · 图片与视频生成 API