Grok Imagine 2.0 Ext

grok-imagine-2.0-ext é a geração de texto para imagem Grok Imagine da xAI. Este modelo admite apenas geração; não envie requisições de edição.

Superfície da API

Operação	Endpoint	Modo
Geração de imagens	POST /v1/images/generations	Síncrono
Tarefa de geração de imagens	POST /v1/async/images/generations	Assíncrono

IDs do modelo

ID do modelo	Ideal para
grok-imagine-2.0-ext	Apenas texto para imagem

Preços

ID do modelo	Créditos / imagem
grok-imagine-2.0-ext	2

Campos de requisição

Campo	Tipo	Obrigatório	Descrição
model	string	Sim	Use grok-imagine-2.0-ext. Os IDs distinguem maiúsculas.
prompt	string	Sim	Texto do prompt, até 2.000 caracteres.
n	integer	Não	Número de saídas. Valor inicial 1, máximo 9.
size	string	Não	Tamanho de saída suportado pelo provedor. Encaminhado como está.
quality	string	Não	Valor de qualidade opcional do provedor.
output_format	string	Não	Formato de saída opcional, por exemplo png, quando o origem suportar.
providerOptions	object	Não	Campos adicionais do provedor encaminhados pelo gateway.

Exemplo

cURL

curl https://api.pixapi.ai/v1/images/generations \
  -H "Authorization: Bearer $PIXAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"grok-imagine-2.0-ext","prompt":"Foto editorial de produto em um fundo cinza quente","n":1,"size":"1024x1024"}'

Python

import os
import requests

response = requests.post(
    "https://api.pixapi.ai/v1/images/generations",
    headers={
        "Authorization": f"Bearer {os.environ['PIXAPI_KEY']}",
        "Content-Type": "application/json",
    },
    json={
  "model": "grok-imagine-2.0-ext",
  "prompt": "Foto editorial de produto em um fundo cinza quente",
  "n": 1,
  "size": "1024x1024"
},
)
response.raise_for_status()
print(response.json())

JavaScript

const response = await fetch('https://api.pixapi.ai/v1/images/generations', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.PIXAPI_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
  "model": "grok-imagine-2.0-ext",
  "prompt": "Foto editorial de produto em um fundo cinza quente",
  "n": 1,
  "size": "1024x1024"
}),
});

if (!response.ok) {
  throw new Error(await response.text());
}

console.log(await response.json());

Go

package main

import (
  "bytes"
  "fmt"
  "io"
  "net/http"
  "os"
)

func main() {
  body := []byte(`{
  "model": "grok-imagine-2.0-ext",
  "prompt": "Foto editorial de produto em um fundo cinza quente",
  "n": 1,
  "size": "1024x1024"
}`)

  req, err := http.NewRequest(
    "POST",
    "https://api.pixapi.ai/v1/images/generations",
    bytes.NewBuffer(body),
  )
  if err != nil {
    panic(err)
  }
  req.Header.Set("Authorization", "Bearer "+os.Getenv("PIXAPI_KEY"))
  req.Header.Set("Content-Type", "application/json")

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

  result, _ := io.ReadAll(resp.Body)
  fmt.Println(string(result))
}

Para requisições assíncronas e polling, consulte Tarefas assíncronas de mídia.

O formato de resposta compartilhado está na Referência da API.