Name: Seedream 4 – Generate & Edit 4K Images | $0.04/call | API.market
Brand: magicapi
SKU: api-magicapi-text-to-image-highres-bytedance-seedream-4
Availability: InStock
Author: API Market

Shashank Agarwal

# 🖼️ High-Res Text-to-Image API (Seedream-4) - Generate & Edit in 4K

## Overview
The High-Res Text-to-Image API (Seedream-4) enables the creation and editing of stunning 4K resolution images from text prompts. With the advanced capabilities of the bytedance/seedream-4 model, users can generate high-quality images or make precise single-sentence edits.

## Features
- Generate high-resolution images (up to 4K) from text descriptions
- Edit existing images with precise single-sentence prompts
- Support for diverse image aspect ratios
- Custom image dimensions for fine-tuned results
- Enhanced prompt functionality for improved quality
- Multiple image generation modes, including sequential group generation

## Use Cases
1. **E-commerce Product Imagery**: Create high-quality product images for online stores using detailed product descriptions.
2. **Marketing and Advertising**: Generate eye-catching visuals for advertising campaigns tailored to specific themes or slogans.
3. **Content Creation**: Artists and content creators can swiftly produce concept art or illustrations based on short descriptions.
4. **Architecture and Interior Design**: Design professionals can visualize and present interior and exterior layouts from brief descriptions.
5. **Education and Research**: Generate visual aids and illustrations for educational materials and research presentations.

## Visual Examples

### Example 1: 
**Input Prompt**: "a photo of a store front called 'Seedream 4', it sells books, a poster in the window says 'Seedream 4 now on API.Market'"
![Store front image](https://blog.api.market/wp-content/uploads/2025/12/seedream4-api-market-scaled.jpg)

## Pricing
- **Pay As You Go (PAYG)**: Only pay for the images you process.
- **1 API unit = 1 image processed**
- **Free GET requests**: Checking the status of predictions is free and does not count toward your API units.
- No monthly subscription fees or usage limits, ensuring you pay only for the services you use.

## API Documentation

### Base URL
All API requests should be made to: `https://prod.api.market/api/v1/magicapi/text-to-image-highres-bytedance-seedream-4`

### Authentication
Authentication is handled via API key. Include your API key in the request header:
```
x-api-market-key: YOUR_API_MARKET_KEY
```

### Asynchronous Processing
**IMPORTANT**: This API uses asynchronous processing for predictions. The processing time varies depending on the complexity of the request. Follow these steps for asynchronous processing:

1. **Submit a prediction request** to the POST endpoint.
2. **Receive a prediction ID** in the response.
3. **Poll the GET endpoint** with the prediction ID to check the status.
4. **Continue polling** until the prediction is complete.

Implement a polling interval of 1 second between checks and handle timeouts of up to 600 seconds (10 minutes).

### Endpoints

#### Create Prediction

```bash
# Example for creating a prediction
curl -X POST "https://prod.api.market/api/v1/magicapi/text-to-image-highres-bytedance-seedream-4/predictions" \
  -H "Content-Type: application/json" \
  -H "x-api-market-key: YOUR_API_MARKET_KEY" \
  -d '{
    "version": "cf7d431991436f19d1c8dad83fe463c729c816d7a21056c5105e75c84a0aa7e9",
    "input": {
      "size": "2K",
      "width": 2048,
      "height": 2048,
      "prompt": "a photo of a store front called \"Seedream 4\", it sells books, a poster in the window says \"Seedream 4 now on API.Market\"",
      "max_images": 1,
      "image_input": [],
      "aspect_ratio": "4:3",
      "sequential_image_generation": "disabled"
    }
  }'
```

**Response Example**:
```json
{
  "id": "ufawqhfynnddngldkgtslldrkq",
  "version": "cf7d431991436f19d1c8dad83fe463c729c816d7a21056c5105e75c84a0aa7e9",
  "status": "starting",
  "created_at": "2025-12-08T11:56:20.026Z"
}
```

#### Get Prediction Status

```bash
# Check prediction status with the ID
curl -X GET "https://prod.api.market/api/v1/magicapi/text-to-image-highres-bytedance-seedream-4/predictions/ufawqhfynnddngldkgtslldrkq" \
  -H "x-api-market-key: YOUR_API_MARKET_KEY"
```

**Response Example**:
```json
{
  "id": "ufawqhfynnddngldkgtslldrkq",
  "status": "succeeded",
  "output": [
    "https://blog.api.market/wp-content/uploads/2025/12/seedream4-api-market-scaled.jpg"
  ],
  "created_at": "2023-01-01T12:00:00.000Z",
  "started_at": "2023-01-01T12:00:05.000Z",
  "completed_at": "2023-01-01T12:01:00.000Z"
}
```

## Status Codes

- **200 OK**: Request successful
- **201 Created**: Resource successfully created
- **400 Bad Request**: Invalid input parameters
- **401 Unauthorized**: Missing or invalid API key
- **403 Forbidden**: Insufficient permissions
- **404 Not Found**: Resource not found
- **429 Too Many Requests**: Rate limit exceeded
- **500 Internal Server Error**: Server side error
- **503 Service Unavailable**: Service temporarily unavailable

## Rate Limits
Provide rate limit information as necessary:
- **Limit**: Standard rate limits apply to ensure fair usage for all users.
- **Handling**: In case of rate limits, users should implement exponential backoff strategies.

## Error Handling

### Common Errors

**Example Error Response**:
```json
{
  "error": {
    "code": "invalid_parameter",
    "message": "The parameter 'image' is required",
    "status": 400
  }
}
```

**Best Practices**:
- **Interpret responses**: Proper handling of different error codes.
- **Retry strategies**: Implement retry mechanisms for transient errors.

## Implementation Guide

### Example Code

#### JavaScript
```javascript
const apiKey = "YOUR_API_MARKET_KEY";
const baseUrl = "https://prod.api.market/api/v1/magicapi/text-to-image-highres-bytedance-seedream-4";

async function createAndWaitForPrediction(inputData) {
  try {
    const response = await fetch(`${baseUrl}/predictions`, {
      method: "POST",
      headers: {
        "Content-Type": "application/json",
        "x-api-market-key": apiKey
      },
      body: JSON.stringify({ input: inputData, version: "cf7d431991436f19d1c8dad83fe463c729c816d7a21056c5105e75c84a0aa7e9" })
    });
    if (!response.ok) {
      throw new Error(`API error: ${response.status} ${response.statusText}`);
    }
    const prediction = await response.json();
    return await pollForResults(prediction.id);
  } catch (error) {
    console.error("Error:", error);
    throw error;
  }
}

function delay(ms) {
  return new Promise(resolve => setTimeout(resolve, ms));
}

async function pollForResults(predictionId) {
  const MAX_TIMEOUT = 600000;
  const POLL_INTERVAL = 1000;
  const startTime = Date.now();

  while (Date.now() - startTime < MAX_TIMEOUT) {
    const response = await fetch(`${baseUrl}/predictions/${predictionId}`, {
      headers: { "x-api-market-key": apiKey }
    });
    if (!response.ok) {
      throw new Error(`API error: ${response.status} ${response.statusText}`);
    }
    const prediction = await response.json();
    if (prediction.status === "succeeded") {
      return prediction.output;
    }
    if (prediction.status === "failed") {
      throw new Error(`Prediction failed: ${prediction.error || "Unknown error"}`);
    }
    await delay(POLL_INTERVAL);
  }
  throw new Error("Prediction timed out after 10 minutes");
}
```

#### Python
```python
import requests
import time

API_KEY = "YOUR_API_MARKET_KEY"
BASE_URL = "https://prod.api.market/api/v1/magicapi/text-to-image-highres-bytedance-seedream-4"

def create_and_wait_for_prediction(input_data):
    headers = {
        "Content-Type": "application/json",
        "x-api-market-key": API_KEY
    }
    response = requests.post(
        f"{BASE_URL}/predictions",
        headers=headers,
        json={"input": input_data, "version": "cf7d431991436f19d1c8dad83fe463c729c816d7a21056c5105e75c84a0aa7e9"}
    )
    if response.status_code != 200:
        raise Exception(f"API error: {response.status_code} {response.text}")
    prediction = response.json()
    prediction_id = prediction["id"]
    return poll_for_results(prediction_id)

def poll_for_results(prediction_id):
    MAX_TIMEOUT = 600
    POLL_INTERVAL = 1
    headers = {"x-api-market-key": API_KEY}
    start_time = time.time()
    
    while time.time() - start_time < MAX_TIMEOUT:
        response = requests.get(f"{BASE_URL}/predictions/{prediction_id}", headers=headers)
        if response.status_code != 200:
            raise Exception(f"API error: {response.status_code} {response.text}")
        prediction = response.json()
        if prediction["status"] == "succeeded":
            return prediction["output"]
        if prediction["status"] == "failed":
            raise Exception(f"Prediction failed: {prediction.get('error', 'Unknown error')}")
        time.sleep(POLL_INTERVAL)
    
    raise Exception("Prediction timed out after 10 minutes")
```

#### cURL
```bash
# Create a prediction
curl -X POST "https://prod.api.market/api/v1/magicapi/text-to-image-highres-bytedance-seedream-4/predictions" \
  -H "Content-Type: application/json" \
  -H "x-api-market-key: YOUR_API_MARKET_KEY" \
  -d '{
    "input": {
      "prompt": "a photo of a store front called \"Seedream 4\", it sells books, a poster in the window says \"Seedream 4 now on API.Market\""
    },
    "version": "cf7d431991436f19d1c8dad83fe463c729c816d7a21056c5105e75c84a0aa7e9"
  }'

# Check prediction status (replace prediction_id with the actual ID)
curl -X GET "https://prod.api.market/api/v1/magicapi/text-to-image-highres-bytedance-seedream-4/predictions/prediction_id" \
  -H "x-api-market-key: YOUR_API_MARKET_KEY"
```

### Performance Optimization
To optimize API usage and minimize costs:
- Use enhanced prompt functionality judiciously to balance quality and processing time.
- Limit the maximum number of images generated in a single request.
- Utilize custom dimensions to target the exact resolution needed.

## FAQ
1. **What is the recommended interval between polling for prediction status?**
   - We recommend a polling interval of 1 second.

2. **What happens if a prediction fails?**
   - If a prediction fails, the response will contain an error message. Implement proper error handling to manage such cases appropriately.

3. **Is there a limit on the number of images that can be generated in one request?**
   - Yes, you can specify up to 15 images in a single request.

4. **What are the supported image resolutions?**
   - The API supports resolutions of 1K (1024px), 2K (2048px), 4K (4096px), and custom dimensions.

## Contact Us
If you have any questions or need assistance, you can reach out to us through the embedded chat on the bottom right corner of the page or send an email to hello[at]api.market.

Generate and edit stunning 4K images from simple text prompts. Supports precise single-sentence edits. From $0.04/call. Try it free on API.market.