Sora 2 管道快速入门
使用我们兼容 OpenAI 的 API 为 Sora 2 视频管道生成无审查文本。本快速入门涵盖身份验证、基本请求、流式输出和函数调用,助您立即运行文本引擎。
身份验证与基础 URL
我们的 API 使用标准的 OpenAI 兼容身份验证。你需要从仪表板获取 API 密钥,并使用基础 URL https://api.sora2apis.com/v1。将密钥作为 Bearer token 传入 Authorization 头部。此设置适用于任何支持 OpenAI 兼容性的 SDK。
注册账户以获取密钥。新账户可获得 7 天有效期、价值 $0.50 的免费试用额度,无需信用卡。付费充值起始金额为 $10。密钥在注册后立即生成,且可随时重新生成。
curl https://api.sora2apis.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
}'
聊天补全接口
核心接口为 POST /v1/chat/completions。它接受设置为 uncensored 的 model 字段,这是一个开放权重模型,针对合法成人用途进行了调整,不会拒绝内容。它不是 GPT、Claude 或其他厂商的模型。该模型拥有 100,000 token 的上下文窗口,涵盖提示词和补全内容。
通过 messages 数组发送文本输入。API 返回适用于视频生成管道的文本输出。此接口不支持嵌入、音频或视频生成。它严格为文本输入、文本输出。
from openai import OpenAI
client = OpenAI(base_url="https://api.sora2apis.com/v1", api_key="YOUR_KEY")
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)
流式响应 (SSE)
对于实时文本生成,请在请求中设置 stream: true。API 返回服务器发送事件 (SSE),允许你处理生成的 token。这对于长脚本或字幕很有用,你可以显示进度或增量馈送数据。
每个 SSE 事件包含响应的部分增量。聚合这些增量以重建完整文本。流式响应遵循标准的 OpenAI SSE 格式,确保与大多数现代 SDK 兼容。这非常适合 Sora 2 工作流中的动态内容生成。
stream = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Tell the story in second person."}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)
工具与函数调用
API 支持工具和函数调用,允许你为模型定义自定义函数。这对于结构化数据提取或文本管道内的自动化决策很有价值。在 tools 数组中定义你的工具,并指定模型应如何响应。
模型会在适当时返回工具调用,你可以执行这些调用并将其反馈到对话中。这启用了复杂的工作流,其中文本引擎可以与外部系统交互或精确格式化数据以满足视频生成需求。这是高级 Sora 2 管道的强大功能。
速率限制与使用
每个密钥每分钟限制 300 次请求。最大请求体大小为 8 MB。如果超出速率限制,你将收到 429 错误。确保你的应用适当处理重试。每个账户拥有一个 API 密钥,可随时重新生成,旧密钥将失效。
价格为每 100 万输入 token 0.25 美元,每 100 万输出 token 1.00 美元。额度为预付且永不过期。如果余额不足,你将收到 402 错误。无效密钥会导致 401 错误。充值从 10 美元起,金额越大奖励越多。
模型配置
模型 ID 始终为 uncensored。这是一个开放权重模型,运行在我们自己的 GPU 服务器上,针对合法成人内容进行了优化,无拒答。它不是 GPT、Claude、Gemini、Grok 或 DeepSeek。该模型不生成音频、图片或视频。它严格用于文本生成。
你可以调整 temperature 和 max_tokens 等标准参数来控制输出。上下文窗口为 100,000 tokens。这种灵活性允许你针对特定的 Sora 2 视频生成需求微调文本输出。该模型旨在成为你流水线中可靠的文本引擎。
Node.js
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.sora2apis.com/v1", apiKey: process.env.API_KEY });
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);接口能力与限制
购买额度前,请先确认接口是否满足你的需求——以下是全部真实参数。
| 项目 | 说明 |
|---|---|
| 接口格式 | 兼容 OpenAI:任何 OpenAI SDK 或客户端只需更换 base URL 和密钥 |
| 模型 ID | uncensored |
| 接口 | POST /v1/chat/completions · GET /v1/models |
| 认证 | Authorization: Bearer YOUR_KEY |
| Base URL | https://api.sora2apis.com/v1 |
| 流式输出 | 支持 SSE,最后一块包含 token 用量 |
| 上下文窗口 | 100,000 tokens(输入与输出合计) |
| 最大输出 | 不单独限制输出;提示+回复共 100,000 个 token 窗口内,max_tokens 可选 |
| 采样参数 | temperature、top_p、stop、seed、presence_penalty、frequency_penalty |
| JSON 模式 | response_format: {"type": "json_object"} |
| 函数调用 | 支持 tools、tool_choice;回复包含 tool_calls(流式同样支持),结果以 role: tool 消息返回 |
| 请求大小 | 每次请求不超过 8 MB |
| 响应头 | X-Request-Id、X-Balance-USD、X-RateLimit-Limit-Requests、X-RateLimit-Limit-Concurrency |
| 并发 | 每个密钥同时最多 8 个请求 |
| 速率限制 | 每个密钥每分钟 300 次请求 |
| 计费 | 预付额度,按实际 token 用量扣费;错误和拒绝不收费 |
| 赠送额度 | 满 $50 送 5%,满 $100 送 10% |
| 额度有效期 | 付费额度永不过期,无订阅 |
| 充值 | USDT(TRC20)或 USDC(Base),$10–$500 任意整数金额 |
| 价格 | 输入 $0.25 / 百万 tokens · 输出 $1.00 / 百万 tokens |
| 免费试用 | $0.50,有效期 7 天,无需银行卡 · 试用密钥:2 个并发请求,每分钟 60 次;首次充值后恢复完整限额(8 和 300) |
| 密钥 | 每个账户一个有效密钥;生成新密钥后旧密钥失效 |
| 内容政策 | 允许成人内容;涉及未成年人的性内容一律拒绝 |
| 登录 | Google 或邮箱 + 密码 |
错误说明
错误以 JSON 返回,type 字段固定;失败或被拒绝的请求不计费。
| 状态码 | 类型 | 含义 |
|---|---|---|
400 | bad_request | JSON 无效、消息为空、参数错误或超出上下文窗口 |
401 | missing_key · invalid_key · key_revoked | 缺少密钥、密钥错误或已被新密钥替换 |
402 | no_credit | 余额不足——充值后立即恢复 |
403 | content_blocked | 涉及未成年人的性内容——拒绝且不计费 |
404 | not_found | 未知接口 |
413 | request_too_large | 请求体超过 8 MB |
429 | rate_limited · concurrency | 超过每分钟 300 次或 8 个并发——稍后重试 |
503 | upstream_busy | 模型繁忙——几秒后重试 |
问答
上下文窗口大小是多少?
上下文窗口为 100,000 tokens,包含提示词和补全内容。这允许生成长篇幅内容,适用于脚本和详细字幕。
如何处理速率限制?
每个密钥每分钟限制 300 次请求。超出限制将返回 429 错误。请在应用中实现指数退避以优雅处理重试。
内容确实无审查吗?
模型不拒绝合法的成人、虚构、安全研究或争议性话题。但涉及未成年人的色情内容始终会被屏蔽。它在法律范围内旨在提供创作自由。