获取视频任务状态

OpenAI 兼容的视频任务状态查询接口。

返回视频任务的详细状态信息。

Try It

GET/v1/videos/{task_id}https://api-platform.ope.ai

认证

使用 Bearer Token 认证。

• Header：Authorization: Bearer <token>
• 示例：Authorization: Bearer sk-xxxxxx

Path 参数

参数	类型	必填	说明
task_id	string	是	视频任务 ID

请求示例

下方域名为示例：https://api-platform.ope.ai。内容参考 getvideo。

cURL

curl -X GET "https://api-platform.ope.ai/v1/videos/{task_id}" \
  -H "Authorization: Bearer $OPEAI_API_KEY"

JavaScript

const apiKey = process.env.OPEAI_API_KEY;
const taskId = "{task_id}";
const url = `https://api-platform.ope.ai/v1/videos/${taskId}`;

const res = await fetch(url, {
  method: "GET",
  headers: { Authorization: `Bearer ${apiKey}` },
});

console.log(await res.json());

Go

package main

import (
  "fmt"
  "net/http"
  "os"
)

func main() {
  req, _ := http.NewRequest("GET", "https://api-platform.ope.ai/v1/videos/{task_id}", nil)
  req.Header.Set("Authorization", "Bearer "+os.Getenv("OPEAI_API_KEY"))

  resp, err := http.DefaultClient.Do(req)
  if err != nil {
    panic(err)
  }
  defer resp.Body.Close()
  fmt.Println(resp.Status)
}

Python

import os
import requests

resp = requests.get(
  "https://api-platform.ope.ai/v1/videos/{task_id}",
  headers={"Authorization": f"Bearer {os.environ.get('OPEAI_API_KEY')}"},
  timeout=60,
)

print(resp.json())

Java

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
  public static void main(String[] args) throws Exception {
    String apiKey = System.getenv("OPEAI_API_KEY");
    String url = "https://api-platform.ope.ai/v1/videos/{task_id}";

    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create(url))
      .header("Authorization", "Bearer " + apiKey)
      .GET()
      .build();

    HttpClient client = HttpClient.newHttpClient();
    HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
    System.out.println(response.statusCode());
    System.out.println(response.body());
  }
}

C#

using System;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Threading.Tasks;

public class Program
{
  public static async Task Main()
  {
    var apiKey = Environment.GetEnvironmentVariable("OPEAI_API_KEY");
    var url = "https://api-platform.ope.ai/v1/videos/{task_id}";

    using var http = new HttpClient();
    http.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", apiKey);

    var resp = await http.GetAsync(url);
    Console.WriteLine((int)resp.StatusCode);
    Console.WriteLine(await resp.Content.ReadAsStringAsync());
  }
}

响应示例

200

{
  "id": "video_690d9b52e2b081908a05ded32cbfc629",
  "object": "video",
  "status": "completed",
  "created_at": 1762499410,
  "progress": 100,
  "model": "sora-2",
  "prompt": "",
  "size": "1280x720",
  "seconds": "4"
}

404

{
  "error": {
    "message": "string",
    "type": "string",
    "param": "string",
    "code": "string"
  }
}