# bytedance/seedream-5.0/edit

> Seedream 5.0 edit function enables precise and controllable image manipulation. It employs strong instruction adherence to significantly reduce hallucinations, and supports feature migration and reference examples, automatically learning transformation logic for the one-click reuse of styles or operations.

## Overview

- **Endpoint**: `https://api.shortapi.ai/api/v1/job/create`
- **Model ID**: `bytedance/seedream-5.0/edit`
- **Category**: image-to-image
- **Kind**: inference

## Pricing

Lite mode: Your request will be charged at $0.033 per image.

For more details, please check our pricing page.

## API Information

This model can be used via our HTTP API or more conveniently via our client libraries.
See the input and output schema below, as well as the usage examples.

### Input Schema

The API accepts the following input parameters:

- **`mode`** (`string`, _required_):
  Image Generation Mode.
  - Default: `lite`
  - Options: "lite"

- **`prompt`** (`string`, _required_):
  Text prompt
  - Examples: "An action shot of a black lab swimming..."

- **`num_images`** (`int`, _optional_):
  The number of images to generate
  - Default: `1`
  - Options: "1", "2", "3", "4", "5", "6"

- **`image_urls`** (`list<string>`, _required_):
  The URLs of the images to use for image-to-image generation or image editing. Maximum 10 images

- **`aspect_ratio`** (`string`, _required_):
  The aspect ratio of the generated image
  - Options: "1:1", "9:16", "16:9", "4:3", "3:4", "3:2", "2:3", "21:9"

- **`resolution`** (`string`, _required_):
  Output image resolution
  - Default: `2k`
  - Options: "2k", "3k"

### Output Schema

The API returns a JSON response with a `job_id` for tracking the request status.

**Create Job Response:**
```json
{
  "code": 0,
  "data": {
    "amount": "0.02",
    "job_id": "<JOB_ID>"
  }
}
```

**Query Job Result (when status is 2, meaning succeeded):**
```json
{
  "code": 0,
  "data": {
    "status": 2,
    "result": {
      "images": [{ "url": "https://..." }]
    }
  }
}
```

## Use Example

To use this model, make an HTTP POST request to the API endpoint, then poll for results using the returned `job_id`.

### Bash (cURL)
```bash
# Step 1: Create a job
response=$(curl --request POST \
  --url https://api.shortapi.ai/api/v1/job/create \
  --header "Authorization: Bearer $SHORTAPI_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "bytedance/seedream-5.0/edit",
  "args": {
    "mode": "lite",
    "prompt": "This is a bold illustrated portrait, referencing the uploaded reference image. The work employs a hand-painted ink style with bold, powerful lines and detailed treatments such as cross-hatching. The face is superimposed on a richly textured collage of vintage newspaper clippings, creating a multi-layered mixed-media effect. Vibrant blue and orange paint drips vertically, covering the portrait. The overall tone is warm and soft, combining retro graphic design aesthetics, poster art composition, and high contrast, blending contemporary pop art with vintage print styles, with extremely fine details.",
    "image_urls": ["https://file.shortapi.ai/assets/examples/bytedance/seedream-5.0/edit-image_urls.webp"],
    "aspect_ratio": "2:3",
    "resolution": "3k"
  },
  "callback_url": "CALLBACK_URL"
}')
JOB_ID=$(echo "$response" | grep -o '"job_id": *"[^"]*"' | sed 's/"job_id": *//; s/"//g')

# Step 2: Poll for results
curl --request GET \
  --url "https://api.shortapi.ai/api/v1/job/query?id=$JOB_ID" \
  --header "Authorization: Bearer $SHORTAPI_KEY"
```

### JavaScript (Fetch API)
```javascript
// Step 1: Create a job
const response = await fetch(`https://api.shortapi.ai/api/v1/job/create`, {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${SHORTAPI_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "model": "bytedance/seedream-5.0/edit",
    "args": {
      "mode": "lite",
      "prompt": "This is a bold illustrated portrait, referencing the uploaded reference image. The work employs a hand-painted ink style with bold, powerful lines and detailed treatments such as cross-hatching. The face is superimposed on a richly textured collage of vintage newspaper clippings, creating a multi-layered mixed-media effect. Vibrant blue and orange paint drips vertically, covering the portrait. The overall tone is warm and soft, combining retro graphic design aesthetics, poster art composition, and high contrast, blending contemporary pop art with vintage print styles, with extremely fine details.",
      "image_urls": ["https://file.shortapi.ai/assets/examples/bytedance/seedream-5.0/edit-image_urls.webp"],
      "aspect_ratio": "2:3",
      "resolution": "3k"
    },
    "callback_url": "CALLBACK_URL"
})
});
const data = await response.json();
const JOB_ID = data.job_id;

// Step 2: Poll for results
const result = await fetch(`https://api.shortapi.ai/api/v1/job/query?id=${JOB_ID}`, {
  method: "GET",
  headers: {
    "Authorization": `Bearer ${SHORTAPI_KEY}`
  }
});
const resultData = await result.json();
console.log(resultData);
```

### Python (Requests)
```python
import requests

# Step 1: Create a job
url = "https://api.shortapi.ai/api/v1/job/create"
payload = {
  "model": "bytedance/seedream-5.0/edit",
  "args": {
    "mode": "lite",
    "prompt": "This is a bold illustrated portrait, referencing the uploaded reference image. The work employs a hand-painted ink style with bold, powerful lines and detailed treatments such as cross-hatching. The face is superimposed on a richly textured collage of vintage newspaper clippings, creating a multi-layered mixed-media effect. Vibrant blue and orange paint drips vertically, covering the portrait. The overall tone is warm and soft, combining retro graphic design aesthetics, poster art composition, and high contrast, blending contemporary pop art with vintage print styles, with extremely fine details.",
    "image_urls": ["https://file.shortapi.ai/assets/examples/bytedance/seedream-5.0/edit-image_urls.webp"],
    "aspect_ratio": "2:3",
    "resolution": "3k"
  },
  "callback_url": "CALLBACK_URL"
}
headers = {
    "Authorization": f"Bearer {SHORTAPI_KEY}",
    "Content-Type": "application/json"
}

response = requests.post(url, headers=headers, json=payload)
data = response.json()
JOB_ID = data.get("job_id")

# Step 2: Poll for results
result_url = f"https://api.shortapi.ai/api/v1/job/query?id={JOB_ID}"
result = requests.get(result_url, headers={"Authorization": f"Bearer {SHORTAPI_KEY}"})
print(result.json())
```