Hy-Image-3.5 Preview Geração de imagens

curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "hy-image-v3.5-preview",
    "prompt": "A golden retriever running on a beach in warm evening light",
    "size": "16:9",
    "resolution": "2K"
  }'

import requests

response = requests.post(
    "https://api.apimart.ai/v1/images/generations",
    headers={"Authorization": "Bearer <token>"},
    json={
        "model": "hy-image-v3.5-preview",
        "prompt": "A golden retriever running on a beach in warm evening light",
        "size": "16:9",
        "resolution": "2K"
    }
)
response.raise_for_status()
print(response.json())

const response = await fetch("https://api.apimart.ai/v1/images/generations", {
  method: "POST",
  headers: {
    Authorization: "Bearer <token>",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    model: "hy-image-v3.5-preview",
    prompt: "A golden retriever running on a beach in warm evening light",
    size: "16:9",
    resolution: "2K"
  })
});
if (!response.ok) throw new Error(await response.text());
console.log(await response.json());

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01K..."
    }
  ]
}

POST

images

generations

curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "hy-image-v3.5-preview",
    "prompt": "A golden retriever running on a beach in warm evening light",
    "size": "16:9",
    "resolution": "2K"
  }'

import requests

response = requests.post(
    "https://api.apimart.ai/v1/images/generations",
    headers={"Authorization": "Bearer <token>"},
    json={
        "model": "hy-image-v3.5-preview",
        "prompt": "A golden retriever running on a beach in warm evening light",
        "size": "16:9",
        "resolution": "2K"
    }
)
response.raise_for_status()
print(response.json())

const response = await fetch("https://api.apimart.ai/v1/images/generations", {
  method: "POST",
  headers: {
    Authorization: "Bearer <token>",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    model: "hy-image-v3.5-preview",
    prompt: "A golden retriever running on a beach in warm evening light",
    size: "16:9",
    resolution: "2K"
  })
});
if (!response.ok) throw new Error(await response.text());
console.log(await response.json());

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01K..."
    }
  ]
}

Este endpoint é assíncrono. Após o envio, obtenha o ID em data[0].task_id e use Consulta de tarefas para obter status e imagem. Consulte a cada 3–5 segundos; o tempo limite total recomendado no cliente é de 5 minutos. Pare em completed ou failed.

curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "hy-image-v3.5-preview",
    "prompt": "A golden retriever running on a beach in warm evening light",
    "size": "16:9",
    "resolution": "2K"
  }'

import requests

response = requests.post(
    "https://api.apimart.ai/v1/images/generations",
    headers={"Authorization": "Bearer <token>"},
    json={
        "model": "hy-image-v3.5-preview",
        "prompt": "A golden retriever running on a beach in warm evening light",
        "size": "16:9",
        "resolution": "2K"
    }
)
response.raise_for_status()
print(response.json())

const response = await fetch("https://api.apimart.ai/v1/images/generations", {
  method: "POST",
  headers: {
    Authorization: "Bearer <token>",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    model: "hy-image-v3.5-preview",
    prompt: "A golden retriever running on a beach in warm evening light",
    size: "16:9",
    resolution: "2K"
  })
});
if (!response.ok) throw new Error(await response.text());
console.log(await response.json());

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01K..."
    }
  ]
}

Cabeçalhos da requisição

string

obrigatório

Autenticação Bearer: Bearer <token>, em que <token> é sua APIMart API Key.

Parâmetros da requisição

string

obrigatório

Valor fixo: hy-image-v3.5-preview.

string

obrigatório

Descrição para geração ou edição. Aceita chinês e inglês; não pode estar vazia.

string

padrão:"auto"

Proporção de saída ou dimensões exatas em pixels.

Proporção: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9.
Pixels exatos: por exemplo 2000x1104, respeitando os limites abaixo.
auto ou omitido: o modelo escolhe a proporção conforme o prompt.

Com pixels exatos, resolution não determina as dimensões.

string

padrão:"1K"

Nível de resolução: 1K, 2K ou 4K; padrão 1K.Com pixels exatos, este campo não determina o tamanho. Use sempre um valor aceito; valores não aceitos retornam HTTP 400.

integer

Largura exata em pixels. Deve ser enviada com height e tem prioridade sobre size e resolution.Largura entre 256 e 8192; largura × altura não pode exceder 8.294.400. Recomendam-se múltiplos de 16.

integer

Altura exata em pixels. Deve ser enviada com width.Altura entre 256 e 8192; largura × altura não pode exceder 8.294.400. Recomendam-se múltiplos de 16.

string[]

URLs públicas de referência, até 5 imagens. Omita para texto para imagem; inclua para geração com referências no mesmo endpoint.Aceita JPEG, PNG e WEBP. Recomenda-se menos de 7MB por imagem. As URLs devem ser públicas.

string

Conteúdo que não deve aparecer na imagem.

integer

Semente aleatória; inteiro não negativo. 0 ou omissão usa um valor aleatório.

integer

padrão:"1"

Uma imagem por requisição. Apenas 1 é aceito; outros valores retornam HTTP 400.

Seleção de dimensões

Prioridade: par width / height → pixels exatos em size → proporção ou auto em size junto com resolution. Para pixels exatos, largura e altura devem ficar entre 256 e 8192, com no máximo 8.294.400 pixels no total. Recomendam-se múltiplos de 16 para ambas.

Exemplo de pixels exatos

{
  "model": "hy-image-v3.5-preview",
  "prompt": "A minimalist seaside travel poster with a warm sunset",
  "width": 2000,
  "height": 1104
}

Você também pode omitir width e height e enviar "size": "2000x1104".

Exemplo com imagem de referência

{
  "model": "hy-image-v3.5-preview",
  "prompt": "Make the car in the reference image red, preserving the original background and lighting",
  "image_urls": ["https://example.com/car.png"],
  "size": "16:9",
  "resolution": "2K",
  "negative_prompt": "blur, text watermarks",
  "seed": 42,
  "n": 1
}

Substitua as URLs de exemplo por endereços públicos reais. Para várias referências, adicione URLs em image_urls, até 5 imagens no total.

Resposta de envio

integer

Código de resposta; 200 indica sucesso.

array

Resultado do envio da tarefa.

Mostrar Mostrar campos da tarefa

string

submitted indica envio bem-sucedido, não conclusão da geração.

string

ID da tarefa para consultar status e resultados.

Consultar resultados

curl --request GET \
  --url https://api.apimart.ai/v1/tasks/task_01K... \
  --header 'Authorization: Bearer <token>'

Exemplo de resposta bem-sucedida (URL de imagem ilustrativa):

{
  "code": 200,
  "data": {
    "id": "task_01K...",
    "status": "completed",
    "result": {
      "images": [
        {
          "url": ["https://example.com/generated-image.png"]
        }
      ]
    }
  }
}

pending / processing: continuar consultando.
completed: obter a URL em data.result.images[0].url[0]; url é um array de strings.
failed: parar as consultas e ler o motivo em data.error.message. Reembolso integral. Violações no prompt e reprovações na moderação também são tratadas como falhas.

As imagens são armazenadas no CDN da plataforma. Baixe e salve antes do prazo expires_at informado no resultado.

Cobrança

Cobrança por imagem. Consulte os preços dos modelos.

Com proporção, a cobrança segue o nível resolution.
Com pixels exatos, o lado mais curto determina o nível:

Nível	Lado mais curto
1K	Até 1024 pixels
2K	1025–2048 pixels
4K	Acima de 2048 pixels

Tarefas que falham recebem reembolso integral.

Erros de parâmetros comuns

Os seguintes casos retornam HTTP 400 de forma síncrona, sem criar tarefa nem cobrar:

Problema	Ação
`prompt` vazio	Fornecer um prompt não vazio
`n` diferente de `1`	Solicitar apenas uma imagem por vez
`seed` negativo	Usar inteiro não negativo; `0` significa aleatório
`resolution` não aceita	Usar `1K`, `2K` ou `4K`
Proporção de `size` não aceita	Usar uma das 10 proporções acima ou `auto`
Dimensões fora dos limites	Largura e altura entre 256 e 8192, total máximo de 8.294.400 pixels
Mais de 5 imagens de referência	Reduzir `image_urls` para no máximo 5 imagens

Visão Geral

Modelos

Série de Texto

Série de Imagem

Série de Vídeo

Série de Áudio

Série de Moderação

Gerenciamento de Upload

Gerenciamento de Tarefas

Gerenciamento de Conta

Hy-Image-3.5 Preview Geração de imagens

Cabeçalhos da requisição

Parâmetros da requisição

Seleção de dimensões

Exemplo de pixels exatos

Exemplo com imagem de referência

Resposta de envio

Consultar resultados

Cobrança

Erros de parâmetros comuns

​Cabeçalhos da requisição

​Parâmetros da requisição

​Seleção de dimensões

​Exemplo de pixels exatos

​Exemplo com imagem de referência

​Resposta de envio

​Consultar resultados

​Cobrança

​Erros de parâmetros comuns

Cabeçalhos da requisição

Parâmetros da requisição

Seleção de dimensões

Exemplo de pixels exatos

Exemplo com imagem de referência

Resposta de envio

Consultar resultados

Cobrança

Erros de parâmetros comuns