ShareAI Platform Docs

生成视频

提交返回 HTTP 202,包含 ShareAI 作业 ID 和轮询 URL。.

查看为Markdown格式
本页面内容
POST https://api.shareai.now/api/v1/videos

生成视频

基础 URL
https://api.shareai.now
身份验证
Bearer API 密钥或已批准的 OAuth 访问令牌
必需范围
inference or monetization_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
}'

请求字段#

字段类型含义与限制
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}

检查作业状态#

GET https://api.shareai.now/api/v1/videos/{id}

使用其原始凭证读取视频生成

基础 URL
https://api.shareai.now
身份验证
Bearer API 密钥或已批准的 OAuth 访问令牌
必需范围
inference or monetization_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日

ShareAI平台文档
所有文档

按标题或内容搜索。

询问关于此页面的问题

选择一个助手来探索此页面。您也可以复制页面并将其粘贴到您的对话中。

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI