Tài liệu API

API xóa logo video Sora - Cung cấp video không watermark chất lượng cao

Lưu ý: Bạn cần đăng ký tài khoản để nhận API key và sử dụng dịch vụ.

Base URL: https://sora-api.zdata.vn

URL Format

✅ SEO-Friendly URLs (Khuyến nghị):

  • /api/video/v1/remove-logo
  • /api/video/v1/drafts
  • /api/video/v1/user
  • /api/video/v1/api-keys

Tất cả các API endpoints sử dụng format SEO-friendly URLs ngắn gọn và dễ đọc.

Tính năng

  • • Xóa logo watermark từ video Sora
  • • Lấy danh sách video drafts từ tài khoản Sora
  • • Trả về video gốc chất lượng cao
  • • Hỗ trợ rate limiting
  • • API key authentication

Bảo mật

  • • API key required
  • • Rate limiting per user
  • • HTTPS only
  • • CORS enabled

Xác thực

Tất cả các request API cần có API key trong header X-API-Key

Header Parameters

Tên Loại Bắt buộc Mô tả
X-API-Key string Bắt buộc API key của bạn (lấy từ Dashboard)
Content-Type string Tùy chọn application/json

Ví dụ

X-API-Key: sk_live_abc123def456ghi789jkl012mno345pqr678stu901vwx234yz567890abcdefghijklmnopqrstuvwxyz
POST

Lấy Video Drafts từ Sora

https://sora-api.zdata.vn/api/video/v1/drafts

Mô tả

API này cho phép bạn lấy danh sách tất cả video drafts từ tài khoản Sora của bạn thông qua access token.

Lưu ý: Bạn cần lấy access token từ https://sora.chatgpt.com/api/auth/session sau khi đăng nhập vào tài khoản Sora.

Tham số yêu cầu

Tham số Body

application/json Bắt buộc
access_token string Bắt buộc

Access token từ Sora (lấy từ https://sora.chatgpt.com/api/auth/session)

Hoặc sử dụng format messages:

messages array[object] Tùy chọn

Format tương thích OpenAI

role: "user"
content: "access_token"

Ví dụ Request

{
  "access_token": "eyJhbGciOiJSUzI1NiIs..."
}

Phản hồi trả về

🟢 200 Thành công
application/json
choices array

Thông tin phân tích từ API

data array

Mảng các video drafts, mỗi item chứa:

videos - array: Các file video với URLs (source_path, thumbnail_path, gif_path, mp3_path, md_path, etc.)
id - string: Task ID của video draft
prompt - string: Prompt được sử dụng để tạo video
total integer

Tổng số video drafts tìm thấy

usage object

Token usage statistics

Ví dụ phản hồi

{
  "choices": [
    {
      "index": 0,
      "finish_reason": "stop",
      "message": {
        "role": "assistant",
        "content": "✅ 解析成功\n\n📹 共找到 16 个视频草稿"
      }
    }
  ],
  "usage": {
    "completion_tokens": 75992,
    "total_tokens": 77708,
    "prompt_tokens": 1716
  },
  "object": "chat.completion",
  "data": [
    {
      "videos": [
        {
          "source_path": "https://videos-us3.ss2.life/az/files/...",
          "source_path_source": "https://videos.openai.com/az/files/...",
          "thumbnail_path": "https://videos-us3.ss2.life/az/files/...",
          "gif_path": "https://videos-us3.ss2.life/az/files/...",
          "mp3_path": "https://videos-us3.ss2.life/az/files/...",
          "md_path": "https://videos-us3.ss2.life/az/files/..."
        }
      ],
      "id": "task_01kb451mdsf2h99kx1fwsmfxrc",
      "prompt": "Tạo một video quảng cáo chuyên nghiệp..."
    }
  ],
  "created": 1764695034,
  "model": "sora-drafts-url",
  "id": "chatcmpl-drafts-1764695027",
  "total": 16
}

Ví dụ yêu cầu

cURL

curl --location --request POST 'https://sora-api.zdata.vn/api/video/v1/drafts' \
--header 'X-API-Key: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
  "access_token": "eyJhbGciOiJSUzI1NiIs..."
}'

JavaScript

fetch('https://sora-api.zdata.vn/api/video/v1/drafts', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': 'YOUR_API_KEY'
  },
  body: JSON.stringify({
    access_token: 'eyJhbGciOiJSUzI1NiIs...'
  })
})
.then(response => response.json())
.then(data => {
  console.log('Total drafts:', data.total);
  data.data.forEach(draft => {
    console.log('Task ID:', draft.id);
    console.log('Prompt:', draft.prompt);
    draft.videos.forEach(video => {
      console.log('Video URL:', video.source_path);
      console.log('Thumbnail:', video.thumbnail_path);
    });
  });
})
.catch(error => console.error('Error:', error));

PHP

$ch = curl_init('https://sora-api.zdata.vn/api/video/v1/drafts');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        'Content-Type: application/json',
        'X-API-Key: YOUR_API_KEY'
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'access_token' => 'eyJhbGciOiJSUzI1NiIs...'
    ])
]);

$response = curl_exec($ch);
$data = json_decode($response, true);

echo "Total drafts: " . $data['total'] . "\n";
foreach ($data['data'] as $draft) {
    echo "Task ID: " . $draft['id'] . "\n";
    echo "Prompt: " . $draft['prompt'] . "\n";
    foreach ($draft['videos'] as $video) {
        echo "Video URL: " . $video['source_path'] . "\n";
    }
}

curl_close($ch);

Python

import requests

url = 'https://sora-api.zdata.vn/api/video/v1/drafts'
headers = {
    'Content-Type': 'application/json',
    'X-API-Key': 'YOUR_API_KEY'
}
data = {
    'access_token': 'eyJhbGciOiJSUzI1NiIs...'
}

response = requests.post(url, json=data, headers=headers)
result = response.json()

print(f"Total drafts: {result['total']}")
for draft in result['data']:
    print(f"Task ID: {draft['id']}")
    print(f"Prompt: {draft['prompt']}")
    for video in draft['videos']:
        print(f"Video URL: {video['source_path']}")
        print(f"Thumbnail: {video['thumbnail_path']}")

Cách lấy Access Token

Bước 1: Đăng nhập Sora

Truy cập https://sora.chatgpt.com và đăng nhập tài khoản của bạn.

Bước 2: Lấy Access Token

Sau khi đăng nhập, mở Developer Console (F12) và chạy lệnh sau hoặc truy cập trực tiếp:

https://sora.chatgpt.com/api/auth/session

Bước 3: Copy Access Token

Response sẽ có dạng JSON, copy giá trị accessToken để sử dụng trong API request.

{
  "user": {...},
  "expires": "...",
  "accessToken": "eyJhbGciOiJSUzI1NiIs..."  ← Copy giá trị này
}
GET

Thông tin User

https://sora-api.zdata.vn/api/video/v1/user

Lấy thông tin user hiện tại (yêu cầu authentication)

Response Example

{
  "id": 1,
  "username": "user123",
  "email": "user@example.com",
  "full_name": "User Name",
  "created_at": "2025-01-01 00:00:00"
}
GET

Quản lý API Keys

GET /api/video/v1/api-keys

Lấy danh sách API keys của user

https://sora-api.zdata.vn/api/video/v1/api-keys

POST /api/video/v1/api-keys

Tạo API key mới

https://sora-api.zdata.vn/api/video/v1/api-keys

Request Body

{
  "name": "My API Key"
}

Mã lỗi

Mô tả
400 Bad Request - Dữ liệu request không hợp lệ
401 Unauthorized - API key không hợp lệ hoặc thiếu
429 Too Many Requests - Vượt quá rate limit
500 Internal Server Error - Lỗi server