一个 API key,调用你需要的所有模型
通过兼容 OpenAI 的接口调用主流大模型,通过同一套队列 API 生成图像、视频、音频和 3D。同一个 key,同一个钱包。
继续使用你已有的 OpenAI SDK,只需替换 base URL 和 key。
curl https://www.genspark.ai/api/v1/chat/completions \
-H "Authorization: Bearer $GENSPARK_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-5-5",
"messages": [{"role": "user", "content": "Write a haiku about queues."}]
}'import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["GENSPARK_API_KEY"],
base_url="https://www.genspark.ai/api/v1",
)
r = client.chat.completions.create(
model="claude-sonnet-5-5",
messages=[{"role": "user", "content": "Write a haiku about queues."}],
)
print(r.choices[0].message.content)import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.GENSPARK_API_KEY,
baseURL: "https://www.genspark.ai/api/v1",
});
const r = await client.chat.completions.create({
model: "claude-sonnet-5-5",
messages: [{ role: "user", content: "Write a haiku about queues." }],
});
console.log(r.choices[0].message.content);# Submit, then poll the status_url from the 202 response.
curl -X POST https://www.genspark.ai/api/v1/queue/fal-ai/flux-3 \
-H "Authorization: Bearer $GENSPARK_API_KEY" \
-H "Content-Type: application/json" \
-d '{"prompt": "A lighthouse at dawn, film photo"}'可以调用什么
文本模型和媒体模型共用一个 base URL。
-
文本
Chat Completions 和 Responses,支持流式输出。覆盖 OpenAI、Anthropic、Google 等厂商的模型。
-
图像
文生图和图生图。
-
视频
文生视频和图生视频,部分模型支持首尾帧控制。
-
音频
语音、音乐和音效。
-
3D
文生 3D 和图生 3D,输出场景和网格模型。
为生产环境而建
-
兼容 OpenAI
把 OpenAI SDK 或任何支持自定义 OpenAI base URL 的客户端指向 Genspark 即可。
-
一个 key,全部模态
同一个 key 既能调用对话模型,也能调用媒体队列,不用逐家厂商开账号。
-
一个团队钱包
组织管理员给 API 钱包充值,成员的 key 都从这里扣费。它与 Genspark 会员积分相互独立。
-
按 key 管控
为每个 key 设置权限范围、模型白名单或黑名单、消费上限和并发上限。轮换密钥时 key id 不变。
-
请求日志和用量
每次调用都会记录模型、状态和费用,可以按 key 筛选。
-
队列 API 和 webhook
提交耗时较长的媒体任务后,可以轮询、订阅状态流,或在结果就绪时接收带签名的 webhook。
三步完成第一次调用
-
给 API 钱包充值
由组织管理员向 API 钱包充值。
-
创建 key
打开 API 平台,创建 key 并复制密钥。密钥只显示一次。
-
发起调用
设置 base URL,发送第一个请求。
Base URLhttps://www.genspark.ai/api/v1
适用于 OpenAI 官方 SDK,以及 Cursor、Cline、ChatBox、GenOffice 等支持自定义 OpenAI base URL 的客户端。
常见问题
谁可以使用 GensparkRouter?
目前正在向 Genspark Team 组织开放。组织开通 API 平台后,成员即可创建 key。
可以配合 OpenAI SDK 使用吗?
可以。Chat Completions 和 Responses 遵循 OpenAI 格式,设置 base URL 并使用 Genspark 的 key 即可。
如何计费?
文本模型按 token 计费,媒体模型按生成次数计费,价格以各模型的标价为准。费用从组织预充值的 API 钱包扣除,与 Genspark 会员积分相互独立。
API key 能访问什么?
只能调用模型。key 无法访问其他 Genspark 产品,也无法访问你 Genspark 账号里的数据。
媒体请求没有完成会扣费吗?
不会。请求失败、被内容审核拒绝、超时,或在排队时被取消,都会退款。
开始构建
在 API 平台创建 key,发起第一次调用。
获取 API key