Grok Imagine Image 2.0 · Text to Image

Unganisha

Kitambulisho cha modeli xai/grok-imagine-image/v2.0/text-to-image

# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/xai/grok-imagine-image/v2.0/text-to-image?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

const API = "https://api.doitong.ru/v1";
const headers = {
  "Authorization": "Bearer " + process.env.DOITONG_API_KEY,
  "Content-Type": "application/json",
};

// Run the model; wait up to 20 s for the finished result in the same call
let res = await fetch(API + "/run/xai/grok-imagine-image/v2.0/text-to-image?wait=20", {
  method: "POST",
  headers,
  body: JSON.stringify({
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }),
});
let request = await res.json();
if (!res.ok) throw new Error(request.error.code + ": " + request.error.message);

// Not finished yet: long-poll until it is
while (request.status === "queued" || request.status === "running") {
  res = await fetch(API + "/requests/" + request.id + "?wait=20", { headers });
  request = await res.json();
}
if (request.status !== "succeeded") throw new Error(JSON.stringify(request.error));
console.log(request.outputs.map((o) => o.url), request.cost.credits + " API credits ($" + request.cost.usd + ")");

import os
import requests

API = "https://api.doitong.ru/v1"
headers = {"Authorization": "Bearer " + os.environ["DOITONG_API_KEY"]}

payload = {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
}

# Run the model; wait up to 20 s for the finished result in the same call
r = requests.post(API + "/run/xai/grok-imagine-image/v2.0/text-to-image", params={"wait": 20}, json=payload, headers=headers)
request = r.json()
if not r.ok:
    raise RuntimeError(request["error"]["code"] + ": " + request["error"]["message"])

# Not finished yet: long-poll until it is
while request["status"] in ("queued", "running"):
    request = requests.get(API + "/requests/" + request["id"], params={"wait": 20}, headers=headers).json()
if request["status"] != "succeeded":
    raise RuntimeError(request["error"])
print([o["url"] for o in request["outputs"]], request["cost"]["credits"], "API credits", "$" + request["cost"]["usd"])

# 1. Connect once (Claude Code; Cursor, VS Code, Claude Desktop: https://doitong.com/sw/developers/docs/mcp)
claude mcp add --transport http doitong-models https://api.doitong.ru/v1/mcp \
  --header "Authorization: Bearer $DOITONG_API_KEY"

# 2. Your agent calls the "run" tool with:
{
  "model_id": "xai/grok-imagine-image/v2.0/text-to-image",
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }
}

Piga modeli ya Grok Imagine Image 2.0 · Text to Image (xai/grok-imagine-image/v2.0/text-to-image) kupitia Doitong API. Nyaraka za mawakala: https://doitong.com/sw/developers/models/xai/grok-imagine-image/v2.0/text-to-image.md

POST https://api.doitong.ru/v1/run/xai/grok-imagine-image/v2.0/text-to-image?wait=20
Authorization: Bearer $DOITONG_API_KEY
Content-Type: application/json

{
  "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
}

Ikiwa hali ya jibu ni "queued" au "running", piga GET https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20 mara kwa mara hadi iwe "succeeded"; faili ziko kwenye outputs[].url. POST https://api.doitong.ru/v1/quote/xai/grok-imagine-image/v2.0/text-to-image yenye mwili uleule hurejesha bei kamili kabla ya kuendesha.

Faili kama mfano: $ 0.06 salio za API 60 · ≈ ₽ 6.45 faili zako hupimwa kabla ya kuendesha Iendeshe kwenye ukurasa huu

Pata ufunguo wa API

xAI Maandishi hadi Picha hadi 2k #text-to-image#xai#grok

Maandishi-kwa-picha ya Grok Imagine 2.0 yenye uwiano 13 wa pande, mwonekano wa 1k au 2k, na hadi picha 4

OpenAPI Markdown

xAI · Picha

Tokeo lako la kwanza linaonekana hapa

Unda ombi hapa chini na uliendeshe kwa ufunguo wako wa API. Matokeo yanakiliwa kwenye hifadhi yetu, yakihifadhiwa milele au 7 siku bila malipo.

Unda ombi

Price per run

Bei kulingana na uingizaji wako

$ 0.06kwa utekelezaji

salio za API 60 · ≈ ₽ 6.45

Bei: kuanzia $ 0.04

utekelezaji 1 × $ 0.06 (1k) Endesha · $ 0.06

Hutozwa tu ikifanikiwa, na kurejeshewa kiotomatiki ikishindwa.

num_outputs chaguomsingi 1

resolution chaguomsingi 1k

quality chaguomsingi medium

Faili zako hupimwa kabla ya kuendeshwa (urefu, mwonekano, kasi ya fremu); makadirio hurejesha bei kamili na uendeshaji hutozwa kiasi hicho hicho.

Endpoint ya makadirio: POST /quote/{id}

Unda ombi

Vidhibiti vinazalishwa kutoka kwenye schema ya modeli. Msimbo na bei husasishwa unapovibadilisha.

prompt •inahitajika 88 / 8000

Maelezo ya maandishi ya picha ya kuunda.

resolution chaguomsingi 1k

Chaguo la mwonekano wa picha kati ya kawaida (`1k`) na wa juu (`2k`).

quality chaguomsingi medium

Mpangilio wa ubora wa picha iliyozalishwa.

aspect_ratio chaguomsingi 1:1

Uwiano wa upana kwa urefu wa picha ya tokeo.

num_outputs num_images chaguomsingi 1

Idadi ya picha za kuzalisha.

Ya kina output_format · enable_safety_checker

output_format chaguomsingi jpeg

Muundo wa faili wa picha inayotokana.

POST /run/xai/grok-imagine-image/v2.0/text-to-image?wait=20 makadirio → $ 0.06

# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/xai/grok-imagine-image/v2.0/text-to-image?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

const API = "https://api.doitong.ru/v1";
const headers = {
  "Authorization": "Bearer " + process.env.DOITONG_API_KEY,
  "Content-Type": "application/json",
};

// Run the model; wait up to 20 s for the finished result in the same call
let res = await fetch(API + "/run/xai/grok-imagine-image/v2.0/text-to-image?wait=20", {
  method: "POST",
  headers,
  body: JSON.stringify({
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }),
});
let request = await res.json();
if (!res.ok) throw new Error(request.error.code + ": " + request.error.message);

// Not finished yet: long-poll until it is
while (request.status === "queued" || request.status === "running") {
  res = await fetch(API + "/requests/" + request.id + "?wait=20", { headers });
  request = await res.json();
}
if (request.status !== "succeeded") throw new Error(JSON.stringify(request.error));
console.log(request.outputs.map((o) => o.url), request.cost.credits + " API credits ($" + request.cost.usd + ")");

import os
import requests

API = "https://api.doitong.ru/v1"
headers = {"Authorization": "Bearer " + os.environ["DOITONG_API_KEY"]}

payload = {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
}

# Run the model; wait up to 20 s for the finished result in the same call
r = requests.post(API + "/run/xai/grok-imagine-image/v2.0/text-to-image", params={"wait": 20}, json=payload, headers=headers)
request = r.json()
if not r.ok:
    raise RuntimeError(request["error"]["code"] + ": " + request["error"]["message"])

# Not finished yet: long-poll until it is
while request["status"] in ("queued", "running"):
    request = requests.get(API + "/requests/" + request["id"], params={"wait": 20}, headers=headers).json()
if request["status"] != "succeeded":
    raise RuntimeError(request["error"])
print([o["url"] for o in request["outputs"]], request["cost"]["credits"], "API credits", "$" + request["cost"]["usd"])

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "run",
    "arguments": {
      "model_id": "xai/grok-imagine-image/v2.0/text-to-image",
      "input": {
        "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
      },
      "wait_seconds": 20
    }
  }
}

Endesha ombi hili

Ufunguo wa API

Key yako inabaki kwenye kivinjari hiki: inatumwa kwa Doitong API pekee na kuhifadhiwa (localStorage) tu ukiweka tiki kwenye Kumbuka. Kumbuka katika kivinjari hiki Pata ufunguo wa API

Kuhusu Grok Imagine Image 2.0 · Text to Image

Huzalisha picha kutoka kwa `prompt` ya maandishi yenye hadi vibambo 8000. Huzalisha picha 1 hadi 4 kwa kila mwito, ikiwa na uwiano 13 wa pande kutoka 1:2 hadi 2:1 (chaguomsingi 1:1) na mwonekano wa `1k` au `2k`. Tokeo linaweza kuwa jpeg, png au webp, likiwa na `quality` ya chini au ya kati. Jibu linajumuisha kidokezo kilichorekebishwa kilichotumika.

Vigezo

Tuma jina rasmi au jina asilia, si yote mawili. Majina rasmi

JinaAina ChaguomsingiInaruhusiwa Maelezo

promptinahitajika

Ainastring

≤ herufi 8,000

Maelezo ya maandishi ya picha ya kuunda.

num_imagessi lazima num_outputs

Ainainteger

Chaguomsingi1

1 – 4

Idadi ya picha za kuzalisha.

aspect_ratiosi lazima

Ainaenum

Chaguomsingi1:1

2:120:919.5:916:94:33:21:12:33:49:169:19.59:201:2

Uwiano wa upana kwa urefu wa picha ya tokeo.

resolutionsi lazima

Ainaenum

Chaguomsingi1k

1k2k

Chaguo la mwonekano wa picha kati ya kawaida (`1k`) na wa juu (`2k`).

output_formatsi lazima

Ainaenum

Chaguomsingijpeg

jpegpngwebp

Muundo wa faili wa picha inayotokana.

enable_safety_checkersi lazima

Ainaboolean

Chaguomsingitrue

Ukaguzi unaweza kulegezwa kwa kuweka false, ikiwa mpigaji simu ameidhinishwa.

qualitysi lazima

Ainaenum

Chaguomsingimedium

lowmedium

Mpangilio wa ubora wa picha iliyozalishwa.

inahitajika Jina rasmi, pia linakubalika

Tokeo

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t

{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "xai/grok-imagine-image/v2.0/text-to-image",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 60,
    "usd": "0.06",
    "charged": 60,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "output": {
    "images": [
      {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200,
        "width": 1024,
        "height": 768
      }
    ],
    "revised_prompt": "string"
  },
  "outputs": [
    {
      "type": "image",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}

Faili zako, chaguo lakoKila outputs[].url ni nakala kwenye hifadhi yetu: huhifadhiwa milele (hutozwa kwa GB kwa mwezi) au 7 siku bila malipo, kulingana na mpangilio wa akaunti yako au ?storage=.

Muundo uleule kwenye kila modelitype, url, content_type, width, height na duration, kwa picha, video na sauti. output ni kitu cha matokeo cha modeli yenyewe.

Sehemu za tokeo

images: array of object {url, content_type, file_name, file_size, width, height}URL inayoelekeza kwenye picha iliyozalishwa.
revised_prompt: string | nullKidokezo kilichoboreshwa kinachotumika kwa uzalishaji wa picha.