生成视频
提交返回 HTTP 202,包含 ShareAI 作业 ID 和轮询 URL。.
本页面内容
https://api.shareai.now/api/v1/videos生成视频
- 基础 URL
https://api.shareai.now- 身份验证
- Bearer API 密钥或已批准的 OAuth 访问令牌
- 必需范围
inferenceormonetization_gateway
提交返回 HTTP 202,包含 ShareAI 作业 ID 和轮询 URL。发送稳定 Idempotency-Key 标头以重试相同请求。使用不同输入重复使用该密钥将被拒绝。轮询 GET /api/v1/videos/{id} 使用相同的原始凭证。状态包括排队中、待处理、进行中、正在完成、已完成、失败和需要审核。需要审核的结果需要团队协调;轮询不会启动另一个生成过程。.
开始之前#
在您的服务器上设置 SHAREAI_API_KEY,并将模型占位符替换为当前启用的模型。切勿在浏览器代码中暴露 API 密钥。模型、账户、凭证和提供者必须全部允许此操作。以下可选设置需要模型支持;API 安全范围并不保证每个模型支持所有值。.
发送请求#
cURL
curl --fail-with-body --request POST "https://api.shareai.now/api/v1/videos" \
-H "Authorization: Bearer $SHAREAI_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: YOUR_UNIQUE_REQUEST_ID" \
--data '{
"model": "YOUR_ENABLED_VIDEOS_MODEL",
"prompt": "A slow camera move through a quiet forest.",
"duration": 8
}'Python
import json
import os
import urllib.request
payload = {'model': 'YOUR_ENABLED_VIDEOS_MODEL',
'prompt': 'A slow camera move through a quiet forest.',
'duration': 8}
headers = {'Content-Type': 'application/json', 'Idempotency-Key': 'YOUR_UNIQUE_REQUEST_ID'}
headers["Authorization"] = "Bearer " + os.environ["SHAREAI_API_KEY"]
request = urllib.request.Request('https://api.shareai.now/api/v1/videos', data=json.dumps(payload).encode(), headers=headers, method="POST")
with urllib.request.urlopen(request, timeout=180) as response:
result = json.load(response)
print(result)TypeScript
const response = await fetch("https://api.shareai.now/api/v1/videos", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`, ...{"Content-Type": "application/json", "Idempotency-Key": "YOUR_UNIQUE_REQUEST_ID"} },
body: JSON.stringify({
"model": "YOUR_ENABLED_VIDEOS_MODEL",
"prompt": "A slow camera move through a quiet forest.",
"duration": 8
}),
});
if (!response.ok) throw new Error(await response.text());
const result = await response.json();
console.log(result);请求字段#
| 字段 | 类型 | 含义与限制 |
|---|---|---|
model 必需 | 字符串 | 精确启用的公共模型标识符。必须声明此操作并由您的凭证允许。. |
prompt 必需 | 字符串 | 非空生成提示,最多 256 KiB 的 UTF-8 文本。. |
duration | 整数 | 可选请求的视频时长(以秒为单位),范围为 1–600,具体受所选模型进一步限制。实际返回的时长决定时长计费。. |
resolution | 字符串 | 模型支持的分辨率选择器,最多 100 个字符;必须与发布的收费变体匹配。. |
aspect_ratio | 字符串 | 模型支持的宽高比选择器,最多 100 个字符。. |
size | 字符串 | 模型支持的输出尺寸,最多 100 个字符,例如 1024×1024。并非每个模型都支持此选项。. |
generate_audio | 布尔值 | 可选视频音轨选择器。需要模型支持和匹配的收费变体。. |
seed | 整数 | 可选模型支持的种子。视频需要非负整数;可重复性取决于执行者。. |
frame_images | 数组 | 最多两个 image_url 部分,每个部分的 frame_type 为 first_frame 或 last_frame,不能重复。不要将 frame_images 和 input_references 组合使用。. |
input_references | 数组 | 最多 16 个类型化的 image_url 部分,每个部分的 image_url.url 设置为 HTTPS URL 或支持的图像数据 URL。需要模型支持。. |
provider | 对象 | 可选的提供者路由偏好。使用 provider.only 接受的提供者标签,而不是模型 ID 的前缀。账户和凭证限制仍然适用。. |
allow_temporary_retention | 布尔值 | 仅限视频。显式 true 允许在需要的路由上临时保留上游结果。省略/false 会使这些路由不可用。与 provider.zdr:true 冲突;其他操作保留强制性 ZDR。. |
阅读结果#
成功返回 HTTP 202 和 JSON。提交返回 HTTP 202,包含 ShareAI 作业 ID 和轮询 URL。发送稳定 Idempotency-Key 标头以重试相同请求。使用不同输入重复使用该密钥将被拒绝。轮询 GET /api/v1/videos/{id} 使用相同的原始凭证。状态包括排队中、待处理、进行中、正在完成、已完成、失败和需要审核。需要审核的结果需要团队协调;轮询不会启动另一个生成过程。.
计费单位#
视频路由声明其计费单位。每秒路由根据每个返回文件的实际时长结算,而不是请求时长或上游的 USD 成本。请求时长必须在 1 到 600 秒之间,并且受模型支持。保守的信用保留可以覆盖最多四个输出。.
从控制台选择精确启用的模型标识符。其声明的操作和输入/输出能力必须与此端点匹配;文本聊天模型不能替代其他操作。您的凭证、提供者和账户限制仍然适用。.
定价与使用#
费率以选定模型、提供者、单位和变体的 EUR AI 积分发布。仅收费于其活动费率中的维度。估算会在执行前保留积分;最终费用使用测量的使用量。价格可能取决于分辨率、输出格式或使用范围。请检查控制台使用情况以获取最终的 ShareAI 扣款。上游成本字段和媒体字节不会转换为虚构的令牌计数。.
访问与错误#
使用 inference 用于批准的网络成本推理或 monetization_gateway 用于批准的 Builder 加价和接受的计费条款。仅身份访问不授权支出。验证、模型授权、积分不足、费率限制和执行失败会返回结构化 error. 在超时或提交不确定后,请检查使用情况或视频任务,然后再创建另一个可能付费的请求。.
临时视频保留#
某些视频路由需要临时上游保留,以便生成的结果可以被检索。它们需要您明确 allow_temporary_retention:true 接受该视频请求。省略它会使这些路由不可用。此例外仅适用于视频,且绝不允许模型训练或其他操作的保留。显式 ZDR 策略不能被默默削弱。.
JSON
{"allow_temporary_retention": true}检查作业状态#
https://api.shareai.now/api/v1/videos/{id}使用其原始凭证读取视频生成
- 基础 URL
https://api.shareai.now- 身份验证
- Bearer API 密钥或已批准的 OAuth 访问令牌
- 必需范围
inferenceormonetization_gateway
JSON
{
"id": "YOUR_JOB_ID",
"object": "video",
"status": "pending",
"created_at": 1793664000,
"polling_url": "/api/v1/videos/YOUR_JOB_ID"
}上述 JSON 展示了稳定的作业字段,而非真实生成。使用相同的密钥轮询 ShareAI 路径,检查之间保持等待。排队中、待处理、进行中和正在完成表示等待;已完成通过 ShareAI 内容 URL 暴露数据;失败和需要审核表示停止并检查。短暂错误后重试状态读取,但不要自动重新提交生成。不同或已撤销的凭证无法检索作业。.
cURL
curl --fail-with-body "https://api.shareai.now/api/v1/videos/YOUR_JOB_ID" \
-H "Authorization: Bearer $SHAREAI_API_KEY"下载结果#
完成后,每个数据条目都包含一个 ShareAI 内容 URL。获取 GET /api/v1/videos/{id}/content?index=0 使用相同的原始凭证。该端点支持单个 HTTP 字节范围。提供者 URL、私人票据和提供者凭证不会被返回。轮询和下载不会创建第二个推理请求或引发 Monetization Gateway 的摄取费用。完成的任务意味着在文件可下载之前已确认结算。.
cURL
curl --fail-with-body "https://api.shareai.now/api/v1/videos/YOUR_JOB_ID/content?index=0" \
-H "Authorization: Bearer $SHAREAI_API_KEY" --output result.mp4可选的 frame_images 必须包含带有 first_frame 或 last_frame 的 image_url 部分。在一个请求中使用帧图像或参考图像,而不是两者同时使用。模型的持续时间、分辨率和宽高比可能比 API 的安全范围更严格。不支持 Webhooks 和任意回调 URL。.
最近更新日期:2026年11月3日