# Seedream 5 Pro API via PiAPI

Base URL: https://api.piapi.ai
Auth: X-API-Key header (get your key at https://piapi.ai/workspace/key)

Documentation: {{docs:seedream-5-pro}} Available Models

- seedream-5-pro: 1K $0.068/image, 2K $0.136/image
- seedream-5-pro-less-restriction: 1K $0.085/image, 2K $0.17/image

## Text to Image

POST /api/v1/task
{
  "model": "seedream",
  "task_type": "seedream-5-pro",
  "input": {
    "prompt": "A beautiful sunset over mountains, photorealistic, 8K quality",
    "aspect_ratio": "16:9",
    "size": "2K",
    "output_format": "png"
  }
}

## Image Reference

POST /api/v1/task
{
  "model": "seedream",
  "task_type": "seedream-5-pro",
  "input": {
    "prompt": "Transform into oil painting style",
    "image_urls": ["https://example.com/reference.jpg"],
    "aspect_ratio": "1:1",
    "size": "1K"
  }
}

## Get Task Result

GET /api/v1/task/{task_id}

Status: "pending" → "processing" → "completed" or "failed"
Image URL: response.data.output.image_urls[0]

## Quick Start

1. Get API key: https://piapi.ai/workspace/key
2. Top up: https://piapi.ai/workspace/billing
3. POST /api/v1/task
4. Poll GET /api/v1/task/{task_id} until "completed"
5. Get image from response.data.output.image_urls