Seedream4.0 - Edit

Generate content using bytedance/seedream-v4-edit

curl --request POST \
  --url https://api.kie.ai/api/v1/jobs/createTask \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "bytedance/seedream-v4-edit",
  "callBackUrl": "https://your-domain.com/api/callback",
  "input": {
    "prompt": "Refer to this logo and create a single visual showcase for an outdoor sports brand named ‘KIE AI’. Display five branded items together in one image: a packaging bag, a hat, a carton box, a wristband, and a lanyard. Use blue as the main visual color, with a fun, simple, and modern style.",
    "image_urls": [
      "https://file.aiquickdraw.com/custom-page/akr/section-images/1757930552966e7f2on7s.png"
    ],
    "image_size": "square_hd",
    "image_resolution": "1K",
    "max_images": 1
  }
}
'

import requests

url = "https://api.kie.ai/api/v1/jobs/createTask"

payload = {
    "model": "bytedance/seedream-v4-edit",
    "callBackUrl": "https://your-domain.com/api/callback",
    "input": {
        "prompt": "Refer to this logo and create a single visual showcase for an outdoor sports brand named ‘KIE AI’. Display five branded items together in one image: a packaging bag, a hat, a carton box, a wristband, and a lanyard. Use blue as the main visual color, with a fun, simple, and modern style.",
        "image_urls": ["https://file.aiquickdraw.com/custom-page/akr/section-images/1757930552966e7f2on7s.png"],
        "image_size": "square_hd",
        "image_resolution": "1K",
        "max_images": 1
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: 'bytedance/seedream-v4-edit',
    callBackUrl: 'https://your-domain.com/api/callback',
    input: {
      prompt: 'Refer to this logo and create a single visual showcase for an outdoor sports brand named ‘KIE AI’. Display five branded items together in one image: a packaging bag, a hat, a carton box, a wristband, and a lanyard. Use blue as the main visual color, with a fun, simple, and modern style.',
      image_urls: [
        'https://file.aiquickdraw.com/custom-page/akr/section-images/1757930552966e7f2on7s.png'
      ],
      image_size: 'square_hd',
      image_resolution: '1K',
      max_images: 1
    }
  })
};

fetch('https://api.kie.ai/api/v1/jobs/createTask', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.kie.ai/api/v1/jobs/createTask",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'model' => 'bytedance/seedream-v4-edit',
    'callBackUrl' => 'https://your-domain.com/api/callback',
    'input' => [
        'prompt' => 'Refer to this logo and create a single visual showcase for an outdoor sports brand named ‘KIE AI’. Display five branded items together in one image: a packaging bag, a hat, a carton box, a wristband, and a lanyard. Use blue as the main visual color, with a fun, simple, and modern style.',
        'image_urls' => [
                'https://file.aiquickdraw.com/custom-page/akr/section-images/1757930552966e7f2on7s.png'
        ],
        'image_size' => 'square_hd',
        'image_resolution' => '1K',
        'max_images' => 1
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.kie.ai/api/v1/jobs/createTask"

	payload := strings.NewReader("{\n  \"model\": \"bytedance/seedream-v4-edit\",\n  \"callBackUrl\": \"https://your-domain.com/api/callback\",\n  \"input\": {\n    \"prompt\": \"Refer to this logo and create a single visual showcase for an outdoor sports brand named ‘KIE AI’. Display five branded items together in one image: a packaging bag, a hat, a carton box, a wristband, and a lanyard. Use blue as the main visual color, with a fun, simple, and modern style.\",\n    \"image_urls\": [\n      \"https://file.aiquickdraw.com/custom-page/akr/section-images/1757930552966e7f2on7s.png\"\n    ],\n    \"image_size\": \"square_hd\",\n    \"image_resolution\": \"1K\",\n    \"max_images\": 1\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.kie.ai/api/v1/jobs/createTask")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"bytedance/seedream-v4-edit\",\n  \"callBackUrl\": \"https://your-domain.com/api/callback\",\n  \"input\": {\n    \"prompt\": \"Refer to this logo and create a single visual showcase for an outdoor sports brand named ‘KIE AI’. Display five branded items together in one image: a packaging bag, a hat, a carton box, a wristband, and a lanyard. Use blue as the main visual color, with a fun, simple, and modern style.\",\n    \"image_urls\": [\n      \"https://file.aiquickdraw.com/custom-page/akr/section-images/1757930552966e7f2on7s.png\"\n    ],\n    \"image_size\": \"square_hd\",\n    \"image_resolution\": \"1K\",\n    \"max_images\": 1\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.kie.ai/api/v1/jobs/createTask")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"model\": \"bytedance/seedream-v4-edit\",\n  \"callBackUrl\": \"https://your-domain.com/api/callback\",\n  \"input\": {\n    \"prompt\": \"Refer to this logo and create a single visual showcase for an outdoor sports brand named ‘KIE AI’. Display five branded items together in one image: a packaging bag, a hat, a carton box, a wristband, and a lanyard. Use blue as the main visual color, with a fun, simple, and modern style.\",\n    \"image_urls\": [\n      \"https://file.aiquickdraw.com/custom-page/akr/section-images/1757930552966e7f2on7s.png\"\n    ],\n    \"image_size\": \"square_hd\",\n    \"image_resolution\": \"1K\",\n    \"max_images\": 1\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "task_bytedance_1765176680149"
  }
}

POST

api

jobs

createTask

Generate content using bytedance/seedream-v4-edit

curl --request POST \
  --url https://api.kie.ai/api/v1/jobs/createTask \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "bytedance/seedream-v4-edit",
  "callBackUrl": "https://your-domain.com/api/callback",
  "input": {
    "prompt": "Refer to this logo and create a single visual showcase for an outdoor sports brand named ‘KIE AI’. Display five branded items together in one image: a packaging bag, a hat, a carton box, a wristband, and a lanyard. Use blue as the main visual color, with a fun, simple, and modern style.",
    "image_urls": [
      "https://file.aiquickdraw.com/custom-page/akr/section-images/1757930552966e7f2on7s.png"
    ],
    "image_size": "square_hd",
    "image_resolution": "1K",
    "max_images": 1
  }
}
'

import requests

url = "https://api.kie.ai/api/v1/jobs/createTask"

payload = {
    "model": "bytedance/seedream-v4-edit",
    "callBackUrl": "https://your-domain.com/api/callback",
    "input": {
        "prompt": "Refer to this logo and create a single visual showcase for an outdoor sports brand named ‘KIE AI’. Display five branded items together in one image: a packaging bag, a hat, a carton box, a wristband, and a lanyard. Use blue as the main visual color, with a fun, simple, and modern style.",
        "image_urls": ["https://file.aiquickdraw.com/custom-page/akr/section-images/1757930552966e7f2on7s.png"],
        "image_size": "square_hd",
        "image_resolution": "1K",
        "max_images": 1
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: 'bytedance/seedream-v4-edit',
    callBackUrl: 'https://your-domain.com/api/callback',
    input: {
      prompt: 'Refer to this logo and create a single visual showcase for an outdoor sports brand named ‘KIE AI’. Display five branded items together in one image: a packaging bag, a hat, a carton box, a wristband, and a lanyard. Use blue as the main visual color, with a fun, simple, and modern style.',
      image_urls: [
        'https://file.aiquickdraw.com/custom-page/akr/section-images/1757930552966e7f2on7s.png'
      ],
      image_size: 'square_hd',
      image_resolution: '1K',
      max_images: 1
    }
  })
};

fetch('https://api.kie.ai/api/v1/jobs/createTask', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.kie.ai/api/v1/jobs/createTask",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'model' => 'bytedance/seedream-v4-edit',
    'callBackUrl' => 'https://your-domain.com/api/callback',
    'input' => [
        'prompt' => 'Refer to this logo and create a single visual showcase for an outdoor sports brand named ‘KIE AI’. Display five branded items together in one image: a packaging bag, a hat, a carton box, a wristband, and a lanyard. Use blue as the main visual color, with a fun, simple, and modern style.',
        'image_urls' => [
                'https://file.aiquickdraw.com/custom-page/akr/section-images/1757930552966e7f2on7s.png'
        ],
        'image_size' => 'square_hd',
        'image_resolution' => '1K',
        'max_images' => 1
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.kie.ai/api/v1/jobs/createTask"

	payload := strings.NewReader("{\n  \"model\": \"bytedance/seedream-v4-edit\",\n  \"callBackUrl\": \"https://your-domain.com/api/callback\",\n  \"input\": {\n    \"prompt\": \"Refer to this logo and create a single visual showcase for an outdoor sports brand named ‘KIE AI’. Display five branded items together in one image: a packaging bag, a hat, a carton box, a wristband, and a lanyard. Use blue as the main visual color, with a fun, simple, and modern style.\",\n    \"image_urls\": [\n      \"https://file.aiquickdraw.com/custom-page/akr/section-images/1757930552966e7f2on7s.png\"\n    ],\n    \"image_size\": \"square_hd\",\n    \"image_resolution\": \"1K\",\n    \"max_images\": 1\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.kie.ai/api/v1/jobs/createTask")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"bytedance/seedream-v4-edit\",\n  \"callBackUrl\": \"https://your-domain.com/api/callback\",\n  \"input\": {\n    \"prompt\": \"Refer to this logo and create a single visual showcase for an outdoor sports brand named ‘KIE AI’. Display five branded items together in one image: a packaging bag, a hat, a carton box, a wristband, and a lanyard. Use blue as the main visual color, with a fun, simple, and modern style.\",\n    \"image_urls\": [\n      \"https://file.aiquickdraw.com/custom-page/akr/section-images/1757930552966e7f2on7s.png\"\n    ],\n    \"image_size\": \"square_hd\",\n    \"image_resolution\": \"1K\",\n    \"max_images\": 1\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.kie.ai/api/v1/jobs/createTask")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"model\": \"bytedance/seedream-v4-edit\",\n  \"callBackUrl\": \"https://your-domain.com/api/callback\",\n  \"input\": {\n    \"prompt\": \"Refer to this logo and create a single visual showcase for an outdoor sports brand named ‘KIE AI’. Display five branded items together in one image: a packaging bag, a hat, a carton box, a wristband, and a lanyard. Use blue as the main visual color, with a fun, simple, and modern style.\",\n    \"image_urls\": [\n      \"https://file.aiquickdraw.com/custom-page/akr/section-images/1757930552966e7f2on7s.png\"\n    ],\n    \"image_size\": \"square_hd\",\n    \"image_resolution\": \"1K\",\n    \"max_images\": 1\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "task_bytedance_1765176680149"
  }
}

Query Task Status

After submitting a task, use the unified query endpoint to check progress and retrieve results:

Get Task Details

Learn how to query task status and retrieve generation results

For production use, we recommend using the callBackUrl parameter to receive automatic notifications when generation completes, rather than polling the status endpoint.

Market Overview

Explore all available models

Common API

Check credits and account usage

Authorizations

Authorization

string

header

required

All APIs require authentication via Bearer Token.

Get API Key:

Visit API Key Management Page to get your API Key

Usage: Add to request header: Authorization: Bearer YOUR_API_KEY

Note:

Keep your API Key secure and do not share it with others
If you suspect your API Key has been compromised, reset it immediately in the management page

Body

application/json

model

enum<string>

default:bytedance/seedream-v4-edit

required

The model name to use for generation. Required field.

Must be bytedance/seedream-v4-edit for this endpoint

Available options:

bytedance/seedream-v4-edit

Example:

"bytedance/seedream-v4-edit"

callBackUrl

string<uri>

The URL to receive generation task completion updates. Optional but recommended for production use.

System will POST task status and results to this URL when generation completes
Callback includes generated content URLs and task information
Your callback endpoint should accept POST requests with JSON payload containing results
Alternatively, use the Get Task Details endpoint to poll task status
To ensure callback security, see Webhook Verification Guide for signature verification implementation

Example:

"https://your-domain.com/api/callback"

input

object

Input parameters for the generation task

Show child attributes

Response

Request successful

code

enum<integer>

Response status code

200: Success - Request has been processed successfully
401: Unauthorized - Authentication credentials are missing or invalid
402: Insufficient Credits - Account does not have enough credits to perform the operation
404: Not Found - The requested resource or endpoint does not exist
422: Validation Error - The request parameters failed validation checks
429: Rate Limited - Request limit has been exceeded for this resource
455: Service Unavailable - System is currently undergoing maintenance
500: Server Error - An unexpected error occurred while processing the request
501: Generation Failed - Content generation task failed
505: Feature Disabled - The requested feature is currently disabled

Available options:

200,

401,

402,

404,

422,

429,

455,

500,

501,

505

msg

string

Response message, error description when failed

Example:

"success"

data

object

Show child attributes

Image Models

Video Models

Music Models

Chat Models

Veo3.1 API

Suno API

Seedream4.0 - Edit

Query Task Status

Get Task Details

Market Overview

Common API

Authorizations

Body

Response

​Query Task Status

Get Task Details

​Related Resources

Market Overview

Common API

Authorizations

Body

Response

Query Task Status

Related Resources