Sora透かし削除API

# Remove Sora Watermark API Documentation

## Base URL
https://savesora.com

## Authentication
All API requests require an `api_key` parameter for authentication.

## Endpoints

### 1. Download Video (Remove Watermark)
- **URL**: POST /api/v1/download
- **Description**: Remove watermark from a Sora video and get download links
- **Cost**: 1 credit per request

**Request Body (JSON):**
```json
{
  "api_key": "YOUR_API_KEY",
  "video_url": "https://sora.chatgpt.com/p/s_xxx"
}
```

**Success Response (200):**
```json
{
  "code": 200,
  "msg": "watermark removed successfully",
  "data": {
    "post_id": "s_xxx",
    "prompt": "Original video prompt text",
    "thumbnail": "https://thumbnail-url",
    "download_links": {
      "mp4": "https://download-url.mp4",
      "mp4_source": "https://source-url.mp4"
    },
    "credits_used": 1,
    "remaining_credits": 99
  }
}
```

**Response Fields:**
| Field | Description |
|-------|-------------|
| post_id | Unique video ID |
| prompt | Original video description/prompt |
| thumbnail | Video cover image URL |
| download_links.mp4 | Watermark-free video download URL |
| download_links.mp4_source | Original video with watermark |
| credits_used | Credits consumed for this request |
| remaining_credits | Your remaining credit balance |

### 2. Check Credits Balance
- **URL**: POST /api/v1/credits
- **Description**: Check your API credit balance

**Request Body (JSON):**
```json
{
  "api_key": "YOUR_API_KEY"
}
```

**Success Response (200):**
```json
{
  "code": 200,
  "msg": "success",
  "data": {
    "paid_credits": 50,
    "onetime_credits": 50,
    "total_credits": 100
  }
}
```

## Error Responses
| Code | Message | Description |
|------|---------|-------------|
| 4001 | api_key is required | API key was not provided |
| 4002 | video_url is required | Video URL was not provided |
| 4003 | invalid api_key | API key is invalid or revoked |
| 4004 | user not found | User account not found |
| 4005 | user account is banned | User account has been deleted or banned |
| 4006 | invalid video url | The Sora video URL format is incorrect |
| 4007 | insufficient credits | Not enough credits for this request |
| 5001 | internal server error | Server error, please try again later |
| 5002 | watermark removal failed | Failed to remove watermark |

**Error Response Example:**
```json
{
  "code": 4007,
  "msg": "insufficient credits",
  "data": {
    "current_credits": 0,
    "required_credits": 1
  }
}
```

## Notes
- Video URL must be a valid Sora video link (format: https://sora.chatgpt.com/p/s_xxx)
- Each successful download consumes 1 credit
- Downloaded videos are watermark-free and in original quality