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} 可選嘅請求影片時長(以秒計),1–600,受所選模型進一步限制。實際返回嘅時長決定時長計費。.

開始之前#

喺你嘅伺服器上設置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整數可選嘅影片音軌選擇器。需要模型支持同匹配嘅收費版本。.
resolution字符串模型支持嘅解像度選擇器,最多 100 個字符;必須同發佈嘅收費變體匹配。.
aspect_ratio字符串模型支持嘅長寬比選擇器,最多 100 個字符。.
size字符串模型支持嘅輸出尺寸,最多 100 個字符,例如 1024×1024。唔係每個模型都支持呢個選項。.
generate_audio布爾值最多兩個 image_url 部分,每個都有 frame_type first_frame 或 last_frame,唔可以重複。唔好將 frame_images 同 input_references 結合使用。.
seed整數可選嘅模型支持嘅種子。視頻需要一個非負整數;可重現性取決於執行器。.
frame_images陣列只限影片。明確嘅 true 允許喺需要嘅路徑上臨時保留上游結果。省略/false 會令嗰啲路徑不可用。與 provider.zdr:true 衝突;其他操作保留強制性嘅 ZDR。.
input_references陣列最多 16 個類型化嘅 image_url 部分,image_url.url 必須設置為 HTTPS URL 或支持嘅圖片數據 URL。需要模型支持。.
provider對象可選嘅提供者路由偏好。使用 provider.only 來接受提供者標籤,而唔係模型 ID 嘅前綴。賬戶同憑證限制仍然適用。.
allow_temporary_retention布爾值成功會返回 HTTP 202 同 JSON。提交會返回 HTTP 202,連同 ShareAI 工作 ID 同輪詢 URL。發送穩定.

閱讀結果#

影片路徑聲明佢哋嘅計費單位。每秒路徑根據每個返回文件嘅實際時長結算,唔係請求嘅時長或者上游嘅 USD 成本。請求時長必須介乎 1 至 600 秒之間,並且受模型支持。一個保守嘅信用保留可以涵蓋最多四個輸出。 Idempotency-Key 標頭以重試相同請求。重用該密鑰但輸入唔同會被拒絕。用相同嘅原始憑證進行輪詢。狀態包括排隊中、待處理、進行中、完成中、已完成、失敗同需要審查。需要審查嘅結果需要團隊協調;輪詢唔會開始另一個生成。 GET /api/v1/videos/{id} 可選嘅請求影片時長(以秒計),1–600,受所選模型進一步限制。實際返回嘅時長決定時長計費。.

計費單位#

某啲影片路徑需要臨時上游保留,以便可以檢索生成嘅結果。佢哋需要你喺嗰個影片請求上明確接受。省略會令嗰啲路徑不可用。呢個例外只適用於影片,並且唔會允許模型訓練或者其他操作嘅保留。明確嘅 ZDR 政策唔可以被默默削弱。.

喺Console中選擇準確啟用嘅模型標識符。佢聲明嘅操作同輸入/輸出能力必須同呢個端點匹配;文字聊天模型唔可以用嚟代替其他操作。你嘅憑證、供應商同賬戶限制仍然適用。.

價格同使用量#

費率以歐元AI點數發佈,適用於所選模型、供應商、單位同變體。只會收取活躍費率中嘅維度。執行前嘅估算會預留點數;最終收費會根據實際使用量計算。價格可能取決於解析度、輸出格式或者使用量區間。喺Console Usage中檢查最終ShareAI扣款。上游成本字段同媒體字節唔會轉換成虛構嘅token數量。.

訪問同錯誤#

使用 inference 用於經批准嘅網絡成本推理或者 monetization_gateway 用於經批准嘅Builder加價同接受嘅計費條款。僅身份訪問唔授權支出。驗證、模型授權、點數不足、速率限制同執行失敗會返回結構化 error. 。喺超時或者提交不確定嘅情況下,檢查Usage或者視頻任務,然後先再創建另一個可能需要付費嘅請求。.

臨時影片保留#

用原始憑證讀取影片生成 allow_temporary_retention:true 上面嘅 JSON 示範咗穩定嘅工作字段,唔係真實生成。用相同嘅密鑰輪詢 ShareAI 路徑,喺檢查之間等待。排隊中、待處理、進行中同完成中意味著等待;已完成會通過 ShareAI 內容 URL 暴露數據;失敗同需要審查意味著停止同檢查。喺短暫錯誤後重試狀態讀取,但唔好自動重新提交生成。唔同或者已撤銷嘅憑證唔可以檢索工作。.

JSON

{"allow_temporary_retention": true}

檢查工作狀態#

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

當完成時,每個數據條目都包含一個 ShareAI 內容 URL。用相同嘅原始憑證提取

基礎 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"
}

該端點支持單一 HTTP 字節範圍。供應商 URL、私人票證同供應商憑證唔會返回。輪詢同下載唔會創建第二次推理請求或者 Monetization Gateway 嘅攝取費用。一個完成嘅工作意味著結算已確認,文件可以下載。.

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、私人票據和提供者憑證永遠不會返回。輪詢和下載不會創建第二次推斷請求或盈利網關攝取費用。完成的工作意味著在文件可下載之前已確認結算。.

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必須包含image_url部分,包括first_frame或者last_frame。喺一個請求中使用frame images或者reference images,但唔可以同時使用。模型嘅時長、解析度同埋比例可能比API嘅安全範圍更加嚴格。唔支持Webhooks同任意嘅callback URLs。.

最後更新日期 2026 年 11 月 3 日

ShareAI平台文檔
所有文檔

按標題或者內容搜尋。

問下關於呢頁嘅問題

選擇一個助手嚟探索呢頁。你亦可以複製呢頁,然後貼喺你嘅對話入面。

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI