Перейти к основному содержанию
POST
/
v1
/
images
/
generations
curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "wan2.7-image-pro",
    "prompt": "A flower shop with exquisite windows, beautiful wooden door, flowers on display"
  }'
import requests

url = "https://api.apimart.ai/v1/images/generations"

payload = {
    "model": "wan2.7-image-pro",
    "prompt": "A flower shop with exquisite windows, beautiful wooden door, flowers on display"
}

headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.json())
const url = "https://api.apimart.ai/v1/images/generations";

const payload = {
  model: "wan2.7-image-pro",
  prompt: "A flower shop with exquisite windows, beautiful wooden door, flowers on display"
};

const headers = {
  "Authorization": "Bearer <token>",
  "Content-Type": "application/json"
};

fetch(url, {
  method: "POST",
  headers: headers,
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));
package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "io/ioutil"
    "net/http"
)

func main() {
    url := "https://api.apimart.ai/v1/images/generations"

    payload := map[string]interface{}{
        "model":  "wan2.7-image-pro",
        "prompt": "A flower shop with exquisite windows, beautiful wooden door, flowers on display",
    }

    jsonData, _ := json.Marshal(payload)

    req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
    req.Header.Set("Authorization", "Bearer <token>")
    req.Header.Set("Content-Type", "application/json")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, _ := ioutil.ReadAll(resp.Body)
    fmt.Println(string(body))
}
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
    public static void main(String[] args) throws Exception {
        String payload = """
        {
          "model": "wan2.7-image-pro",
          "prompt": "A flower shop with exquisite windows, beautiful wooden door, flowers on display"
        }
        """;

        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.apimart.ai/v1/images/generations"))
            .header("Authorization", "Bearer <token>")
            .header("Content-Type", "application/json")
            .POST(HttpRequest.BodyPublishers.ofString(payload))
            .build();

        System.out.println(client.send(request,
            HttpResponse.BodyHandlers.ofString()).body());
    }
}
<?php

$url = "https://api.apimart.ai/v1/images/generations";

$payload = [
    "model" => "wan2.7-image-pro",
    "prompt" => "A flower shop with exquisite windows, beautiful wooden door, flowers on display"
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
?>
require 'net/http'
require 'json'
require 'uri'

url = URI("https://api.apimart.ai/v1/images/generations")

payload = {
  model: "wan2.7-image-pro",
  prompt: "A flower shop with exquisite windows, beautiful wooden door, flowers on display"
}

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 = payload.to_json

response = http.request(request)
puts response.body
import Foundation

let url = URL(string: "https://api.apimart.ai/v1/images/generations")!

let payload: [String: Any] = [
    "model": "wan2.7-image-pro",
    "prompt": "A flower shop with exquisite windows, beautiful wooden door, flowers on display"
]

var request = URLRequest(url: url)
request.httpMethod = "POST"
request.setValue("Bearer <token>", forHTTPHeaderField: "Authorization")
request.setValue("application/json", forHTTPHeaderField: "Content-Type")
request.httpBody = try? JSONSerialization.data(withJSONObject: payload)

let task = URLSession.shared.dataTask(with: request) { data, response, error in
    if let error = error { print("Error: \(error)"); return }
    if let data = data, let str = String(data: data, encoding: .utf8) { print(str) }
}
task.resume()
using System;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        var payload = @"{
            ""model"": ""wan2.7-image-pro"",
            ""prompt"": ""A flower shop with exquisite windows, beautiful wooden door, flowers on display""
        }";

        using var client = new HttpClient();
        client.DefaultRequestHeaders.Add("Authorization", "Bearer <token>");

        var content = new StringContent(payload, Encoding.UTF8, "application/json");
        var response = await client.PostAsync(
            "https://api.apimart.ai/v1/images/generations", content);
        Console.WriteLine(await response.Content.ReadAsStringAsync());
    }
}
{
  "code": "success",
  "data": [
    {
      "task_id": "task_01HX...",
      "status": "processing"
    }
  ]
}
{
  "error": {
    "code": 400,
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}
{
  "error": {
    "code": 401,
    "message": "Authentication failed. Please check your API key.",
    "type": "authentication_error"
  }
}
{
  "error": {
    "code": 402,
    "message": "Insufficient balance. Please top up your account.",
    "type": "payment_required"
  }
}
{
  "error": {
    "code": 429,
    "message": "Too many requests. Please try again later.",
    "type": "rate_limit_error"
  }
}
{
  "error": {
    "code": 500,
    "message": "Internal server error. Please try again later.",
    "type": "server_error"
  }
}
curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "wan2.7-image-pro",
    "prompt": "A flower shop with exquisite windows, beautiful wooden door, flowers on display"
  }'
import requests

url = "https://api.apimart.ai/v1/images/generations"

payload = {
    "model": "wan2.7-image-pro",
    "prompt": "A flower shop with exquisite windows, beautiful wooden door, flowers on display"
}

headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.json())
const url = "https://api.apimart.ai/v1/images/generations";

const payload = {
  model: "wan2.7-image-pro",
  prompt: "A flower shop with exquisite windows, beautiful wooden door, flowers on display"
};

const headers = {
  "Authorization": "Bearer <token>",
  "Content-Type": "application/json"
};

fetch(url, {
  method: "POST",
  headers: headers,
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));
package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "io/ioutil"
    "net/http"
)

func main() {
    url := "https://api.apimart.ai/v1/images/generations"

    payload := map[string]interface{}{
        "model":  "wan2.7-image-pro",
        "prompt": "A flower shop with exquisite windows, beautiful wooden door, flowers on display",
    }

    jsonData, _ := json.Marshal(payload)

    req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
    req.Header.Set("Authorization", "Bearer <token>")
    req.Header.Set("Content-Type", "application/json")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, _ := ioutil.ReadAll(resp.Body)
    fmt.Println(string(body))
}
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
    public static void main(String[] args) throws Exception {
        String payload = """
        {
          "model": "wan2.7-image-pro",
          "prompt": "A flower shop with exquisite windows, beautiful wooden door, flowers on display"
        }
        """;

        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.apimart.ai/v1/images/generations"))
            .header("Authorization", "Bearer <token>")
            .header("Content-Type", "application/json")
            .POST(HttpRequest.BodyPublishers.ofString(payload))
            .build();

        System.out.println(client.send(request,
            HttpResponse.BodyHandlers.ofString()).body());
    }
}
<?php

$url = "https://api.apimart.ai/v1/images/generations";

$payload = [
    "model" => "wan2.7-image-pro",
    "prompt" => "A flower shop with exquisite windows, beautiful wooden door, flowers on display"
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
?>
require 'net/http'
require 'json'
require 'uri'

url = URI("https://api.apimart.ai/v1/images/generations")

payload = {
  model: "wan2.7-image-pro",
  prompt: "A flower shop with exquisite windows, beautiful wooden door, flowers on display"
}

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 = payload.to_json

response = http.request(request)
puts response.body
import Foundation

let url = URL(string: "https://api.apimart.ai/v1/images/generations")!

let payload: [String: Any] = [
    "model": "wan2.7-image-pro",
    "prompt": "A flower shop with exquisite windows, beautiful wooden door, flowers on display"
]

var request = URLRequest(url: url)
request.httpMethod = "POST"
request.setValue("Bearer <token>", forHTTPHeaderField: "Authorization")
request.setValue("application/json", forHTTPHeaderField: "Content-Type")
request.httpBody = try? JSONSerialization.data(withJSONObject: payload)

let task = URLSession.shared.dataTask(with: request) { data, response, error in
    if let error = error { print("Error: \(error)"); return }
    if let data = data, let str = String(data: data, encoding: .utf8) { print(str) }
}
task.resume()
using System;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        var payload = @"{
            ""model"": ""wan2.7-image-pro"",
            ""prompt"": ""A flower shop with exquisite windows, beautiful wooden door, flowers on display""
        }";

        using var client = new HttpClient();
        client.DefaultRequestHeaders.Add("Authorization", "Bearer <token>");

        var content = new StringContent(payload, Encoding.UTF8, "application/json");
        var response = await client.PostAsync(
            "https://api.apimart.ai/v1/images/generations", content);
        Console.WriteLine(await response.Content.ReadAsStringAsync());
    }
}
{
  "code": "success",
  "data": [
    {
      "task_id": "task_01HX...",
      "status": "processing"
    }
  ]
}
{
  "error": {
    "code": 400,
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}
{
  "error": {
    "code": 401,
    "message": "Authentication failed. Please check your API key.",
    "type": "authentication_error"
  }
}
{
  "error": {
    "code": 402,
    "message": "Insufficient balance. Please top up your account.",
    "type": "payment_required"
  }
}
{
  "error": {
    "code": 429,
    "message": "Too many requests. Please try again later.",
    "type": "rate_limit_error"
  }
}
{
  "error": {
    "code": 500,
    "message": "Internal server error. Please try again later.",
    "type": "server_error"
  }
}

Авторизация

Authorization
string
обязательно
Все запросы требуют аутентификации Bearer Token.Перейдите на страницу управления API ключами, чтобы получить свой API Key, затем добавьте его в заголовок запроса:
Authorization: Bearer YOUR_API_KEY

Доступные модели

МодельОписаниеМакс. разрешение (text-to-image)Макс. разрешение (редактирование / последовательная)Цена
wan2.7-image-proПрофессиональная редакция, лучше детали, поддерживает 4K4K2K¥0.50 / изображение
wan2.7-imageСтандартная редакция, более быстрая генерация2K2K¥0.20 / изображение
Тарификация рассчитывается как успешно сгенерированные изображения × цена за единицу. Входные данные не тарифицируются. Разрешение и соотношение сторон не влияют на стоимость. Неудачные запросы не оплачиваются.

Тело запроса

model
string
обязательно
Название модели генерации изображений.
  • wan2.7-image-pro — профессиональная редакция, до 4K для text-to-image
  • wan2.7-image — стандартная редакция, более быстрая, до 2K
prompt
string
Текстовое описание для генерации изображения, до 5000 символов.
  • Text-to-image (без image_urls): обязательно
  • Редактирование изображенияimage_urls): необязательно, но рекомендуется
Пример: "A flower shop with exquisite windows, beautiful wooden door, flowers on display"
image_urls
array<string>
Массив URL входных изображений для сценариев редактирования и мультиизображенческих референсов.Указание этого поля переключает запрос в режим редактирования изображения.Поддерживаемые форматы: HTTP/HTTPS URL; data:image/...;base64,... Base64Ограничения: до 9 изображений; JPEG / PNG / WEBP / BMP; 240–8000 px, соотношение сторон 1:8 ~ 8:1; ≤ 20MB на изображение
Соотношение сторон вывода автоматически соответствует последнему входному изображению. Режим редактирования поддерживает только до 2K — 4K недоступно.
n
integer
по умолчанию:"1"
Количество генерируемых изображений.
  • Стандартный режим: 1–4 (по умолчанию 1)
  • Последовательный режим (enable_sequential: true): 1–12 (по умолчанию 1)
Тарификация за каждое успешно сгенерированное изображение. Предоплата на основе n.
size
string
Выходное разрешение или соотношение сторон. Поддерживает три формата:① Ключевое слово разрешения (рекомендуется): 1K / 2K (по умолчанию) / 4K (только text-to-image для wan2.7-image-pro)② Соотношение сторон: 1:1 / 16:9 / 9:16 / 4:3 / 3:4 / 3:2 / 2:3 (по умолчанию уровень 2K)③ Размеры в пикселях: 1024x1024 или 1024*1024
resolution
string
Ключевое слово уровня разрешения: 1K / 2K / 4K. Можно сочетать с size (соотношение сторон).
МодельСценарийПоддерживаемые уровниДиапазон пикселей
wan2.7-image-proText-to-image (не последовательный)1K / 2K / 4K768×768 ~ 4096×4096
wan2.7-image-proРедактирование / последовательная1K / 2K768×768 ~ 2048×2048
wan2.7-imageВсе сценарии1K / 2K768×768 ~ 2048×2048
negative_prompt
string
Негативный промпт, описывающий элементы, которых следует избегать. Пример: "blurry, distorted, low quality"
watermark
boolean
по умолчанию:"false"
Добавлять ли водяной знак “AI Generated” в правый нижний угол.
seed
integer
Случайное зерно, диапазон 0–2147483647. Одно и то же зерно с идентичными параметрами даёт визуально согласованные результаты.
thinking_mode
boolean
по умолчанию:"true"
Включить улучшенный режим рассуждения для повышения качества изображения за счёт увеличения времени генерации.
Действует только когда последовательный режим отключён и не передано входное изображение.
enable_sequential
boolean
по умолчанию:"false"
Включить режим последовательной генерации изображений — генерирует несколько тематически связных изображений за один запрос. Идеально для раскадровок и серий.
  • Максимум n равен 12 при включении
  • thinking_mode и color_palette игнорируются в последовательном режиме
  • wan2.7-image-pro поддерживает до 2K в последовательном режиме (4K не поддерживается)
bbox_list
array
Ограничивающие рамки для интерактивного редактирования — задаёт точные области для редактирования или вставки контента.Структура: [[[x1, y1, x2, y2], ...], ...]
  • Длина внешнего массива должна совпадать с длиной image_urls
  • Передавайте [] для изображений без ограничивающей рамки
  • Максимум 2 рамки на изображение; координаты — абсолютные значения в пикселях, начало координат (0,0) в левом верхнем углу
Пример: [[], [[989, 515, 1138, 681]]]
color_palette
array<object>
Пользовательская цветовая тема. Только стандартный режим (не последовательный режим).
  • 3–10 записей (рекомендуется 8); каждая запись требует hex и ratio
  • Сумма всех значений ratio должна быть точно равна 100.00%
[
  { "hex": "#C2D1E6", "ratio": "23.51%" },
  { "hex": "#636574", "ratio": "76.49%" }
]

Ответ

code
string
Статус ответа. Возвращает "success" при успехе.
data
array

Примеры

Text-to-image (минимальный)

{
  "model": "wan2.7-image-pro",
  "prompt": "A flower shop with exquisite windows, beautiful wooden door, flowers on display"
}

Text-to-image (с разрешением)

{
  "model": "wan2.7-image-pro",
  "prompt": "Summer beach, blue sky and white clouds, 4K ultra HD",
  "size": "4K",
  "thinking_mode": true
}

Text-to-image (пользовательская цветовая палитра)

{
  "model": "wan2.7-image-pro",
  "prompt": "Minimalist modern living room",
  "size": "2K",
  "color_palette": [
    { "hex": "#C2D1E6", "ratio": "23.51%" },
    { "hex": "#CDD8E9", "ratio": "20.13%" },
    { "hex": "#B5C8DB", "ratio": "15.88%" },
    { "hex": "#C0B5B4", "ratio": "13.27%" },
    { "hex": "#DAE0EC", "ratio": "10.11%" },
    { "hex": "#636574", "ratio": "8.93%" },
    { "hex": "#CACAD2", "ratio": "5.55%" },
    { "hex": "#CBD4E4", "ratio": "2.62%" }
  ]
}

Последовательная генерация изображений

{
  "model": "wan2.7-image-pro",
  "prompt": "Cinematic series: the same stray orange cat, consistent features. First: under cherry blossoms in spring. Second: old street shade in summer. Third: fallen leaves in autumn. Fourth: snow footprints in winter.",
  "enable_sequential": true,
  "n": 4,
  "size": "2K"
}

Редактирование одного изображения

{
  "model": "wan2.7-image",
  "prompt": "Replace the background with a sunset scene, warm color tones",
  "image_urls": ["https://example.com/portrait.jpg"],
  "size": "2K"
}

Мультиизображенческий референс / объединение элементов

{
  "model": "wan2.7-image-pro",
  "prompt": "Apply the graffiti from image 2 onto the car in image 1",
  "image_urls": [
    "https://example.com/car.webp",
    "https://example.com/paint.webp"
  ],
  "size": "2K"
}

Интерактивное редактирование (ограничивающая рамка)

bbox_list соответствует image_urls один к одному. Передавайте [] для изображений без выделения.
{
  "model": "wan2.7-image-pro",
  "prompt": "Place the alarm clock from image 1 into the selected area of image 2, blending naturally",
  "image_urls": [
    "https://example.com/clock.webp",
    "https://example.com/desk.webp"
  ],
  "bbox_list": [
    [],
    [[989, 515, 1138, 681]]
  ],
  "size": "2K"
}
Запрос результатовГенерация изображений выполняется асинхронно. Опрашивайте конечную точку статуса задачи, используя возвращённый task_id, пока status == completed.