Grok Imagine Image 2.0 · Edit

Unganisha

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

# 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/edit?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/edit?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/edit", 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/edit",
  "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 · Edit (xai/grok-imagine-image/v2.0/edit) kupitia Doitong API. Nyaraka za mawakala: https://doitong.com/sw/developers/models/xai/grok-imagine-image/v2.0/edit.md

POST https://api.doitong.ru/v1/run/xai/grok-imagine-image/v2.0/edit?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/edit yenye mwili uleule hurejesha bei kamili kabla ya kuendesha.

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

Pata ufunguo wa API

xAI Uhariri wa Picha hadi 2k #xai#grok#image-editing

Uhariri unaoendeshwa na kidokezo wa hadi picha 5 za ingizo, ukiwa na tokeo la 1k au 2k na uwiano mwingi wa pande ikijumuisha auto

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.44

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 iliyohaririwa.

aspect_ratio chaguomsingi auto

Mpangilio wa uwiano wa pande wa tokeo kwa uhariri wa picha, ambapo `auto` hutumia uwiano wa ingizo la kwanza. Mpangilio huu wa kiotomatiki ni chaguomsingi.

num_outputs num_images chaguomsingi 1

Idadi ya picha za kuzalisha.

Ya kina images · output_format · enable_safety_checker

images image_urls

Dondosha faili, au

URL za picha za kuhariri, zilizotolewa kama orodha yenye picha zisizozidi 5.

output_format chaguomsingi jpeg

Muundo wa faili wa picha inayotokana.

POST /run/xai/grok-imagine-image/v2.0/edit?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/edit?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/edit?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/edit", 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/edit",
      "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 · Edit

Huhariri picha moja au zaidi zilizotolewa katika `image_urls` (hadi 5) kwa kufuata `prompt` ya maandishi yenye hadi herufi 8000. `aspect_ratio` hutoa chaguo kumi na nne, na `auto` ya chaguo-msingi huhifadhi uwiano wa picha ya kwanza ya ingizo. Unaweza kuchagua `resolution` 1k au 2k, `quality` low au medium, na kuomba matokeo 1 hadi 4 katika jpeg, png au webp. Jibu linajumuisha sehemu ya `revised_prompt`.

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

Chaguomsingiauto

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

Mpangilio wa uwiano wa pande wa tokeo kwa uhariri wa picha, ambapo `auto` hutumia uwiano wa ingizo la kwanza. Mpangilio huu wa kiotomatiki ni chaguomsingi.

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.

image_urlssi lazima images

Ainaurl[] · image

URL za picha za kuhariri, zilizotolewa kama orodha yenye picha zisizozidi 5.

qualitysi lazima

Ainaenum

Chaguomsingimedium

lowmedium

Mpangilio wa ubora wa picha iliyohaririwa.

inahitajika Jina rasmi, pia linakubalika

Vigezo vya faili vinakubali URL ya umma ya https://, data: URI ya hadi 10 MB, au file_url ya upakiaji. Faili

Tokeo

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t

{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "xai/grok-imagine-image/v2.0/edit",
  "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 iliyohaririwa.
revised_prompt: string | nullKidokezo kilichoboreshwa kinachotumika kwa uzalishaji wa picha.