Éischt Schrëtt

Schnellstart

Als Markdown weisen Aktualiséiert 2026-10-22

Féiert Är éischt Generatioun an e puer Minutten aus. All 1.496 Modeller akzeptéieren déiselwecht Aart vun Ufro a ginn dee selwechten Ufroobjet zeréck, fir Biller, Video an Audio: léiert et hei eemol.

1. En API-Schlëssel kréien

Erstellt e Schlëssel op https://doitong.com/developers/dashboard#keys a späichert en an enger Ëmfeldvariabel: e gëtt nëmmen eemol ugewisen. All Schlëssel kann säin eegene Budget hunn, sou datt Dir en engem Agent kënnt ginn, ouni de ganze Kont a Gefor ze bréngen. GET /account gëtt Ären API-Saldo zeréck.

export DOITONG_API_KEY="doitong_..."

curl "https://api.doitong.ru/v1/account" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

const res = await fetch("https://api.doitong.ru/v1/account", {
  headers: { Authorization: `Bearer ${process.env.DOITONG_API_KEY}` },
});

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

import os
import requests

r = requests.get(
    "https://api.doitong.ru/v1/account",
    headers={"Authorization": f"Bearer {os.environ['DOITONG_API_KEY']}"},
)
print(r.json())

Laf ginn aus dem API-Saldo vun Ärem Kont an API-Kreditter bezuelt: 1.000 API-Kreditter = 1 $, an all Modell kascht genee de Präis vu sengem Hiersteller. Lued op bei https://doitong.ru/developers/dashboard#balance.

2. Präis ufroen, duerno ausféieren

POST /quote/{model_id} hëlt den Input-JSON a gëtt den exakte Präis zeréck. Et brauch kee Schlëssel a kascht näischt. Déiselwecht Input auszeféieren kascht genee dat: d'Präisufro ass d'Belaaschtung. (E Modell, dat no Notzung verrechent gëtt, ass d'Ausnam: seng Präisufro ass de Maximum, deen d'Lafe ka kaschten, an den net genotzten Deel gëtt nom Laf rembourséiert.)

curl -X POST "https://api.doitong.ru/v1/quote/kling-video/v3/pro/image-to-video" \
  -H "Content-Type: application/json" \
  -d '{"image": "https://example.com/fox.jpg", "duration": 5, "generate_audio": true}'

const res = await fetch("https://api.doitong.ru/v1/quote/kling-video/v3/pro/image-to-video", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ image: "https://example.com/fox.jpg", duration: 5, generate_audio: true }),
});

const quote = await res.json();
console.log(quote.credits, quote.usd); // 840 "0.84"

import requests

r = requests.post(
    "https://api.doitong.ru/v1/quote/kling-video/v3/pro/image-to-video",
    json={"image": "https://example.com/fox.jpg", "duration": 5, "generate_audio": True},
)
print(r.json()["credits"], r.json()["usd"])  # 840 0.84

200 OK · quote

{
  "object": "quote",
  "model": "kling-video/v3/pro/image-to-video",
  "credits": 840,
  "usd": "0.84",
  "unit": "second",
  "quantity": 5,
  "unit_credits": 168,
  "mode": "exact",
  "breakdown": "5 s × 168 API credits"
}

Schéckt dann dee selwechte Body un POST /run/{model_id}. Füügt ?wait=20 bäi, fir d'Verbindung bis zu 20 Sekonnen ze halen: e séiere Modell gëtt d'fertigt Resultat an engem eenzege Reseau-Roundtrip zeréck. Schéckt en Idempotency-Key-Header, sou datt e Retry ni zweemol leeft oder verrechent gëtt.

curl -X POST "https://api.doitong.ru/v1/run/flux/schnell?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: lighthouse-001" \
  -d '{"prompt": "A lighthouse on a rocky coast at dusk, warm light in the window"}'

const res = await fetch("https://api.doitong.ru/v1/run/flux/schnell?wait=20", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.DOITONG_API_KEY}`,
    "Content-Type": "application/json",
    "Idempotency-Key": "lighthouse-001",
  },
  body: JSON.stringify({ prompt: "A lighthouse on a rocky coast at dusk, warm light in the window" }),
});

const request = await res.json();
console.log(request.status, request.outputs[0]?.url);

import os
import requests

r = requests.post(
    "https://api.doitong.ru/v1/run/flux/schnell",
    params={"wait": 20},
    headers={
        "Authorization": f"Bearer {os.environ['DOITONG_API_KEY']}",
        "Idempotency-Key": "lighthouse-001",
    },
    json={"prompt": "A lighthouse on a rocky coast at dusk, warm light in the window"},
)
request = r.json()
print(request["status"], request["outputs"][0]["url"] if request["outputs"] else None)

D'Äntwert ass en Ufroobjet:

200 OK · Ufro

{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "flux/schnell",
  "status": "succeeded",
  "cost": { "credits": 3, "usd": "0.003", "charged": 3, "refunded": 0 },
  "outputs": [
    { "type": "image", "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg", "width": 1024, "height": 768, "stored": true }
  ],
  "error": null
}

3. De Status verfollegen

Wann de Modell nach schafft, wann d'Waardezäit eriwwer ass, kritt Dir 202 Accepted mat der id vun der Ufro an hirem aktuelle status. All Ufro leeft duerch dee selwechte Liewenszyklus:

Liewenszyklus vun enger Ufro

queued Ugeholl a verrechent, waart op en Aarbechter
running De Modell generéiert
Final Statusen:
- succeededDe Präis gouf verrechent; outputs[] enthalen URLen an eiser Späicherung
- failedAutomatesch rembourséiert; de Feeler erkläert firwat
- canceledVirum Resultat gestoppt; rembourséiert

Liest d'Ufro mat hirer ID nach eng Kéier. ?wait=20 funktionéiert och hei, dofir geet eng einfach Schleef duer:

curl "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

const headers = { Authorization: `Bearer ${process.env.DOITONG_API_KEY}` };
let request = await (await fetch("https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t?wait=20", { headers })).json();

while (request.status === "queued" || request.status === "running") {
  const res = await fetch(`https://api.doitong.ru/v1/requests/${request.id}?wait=20`, { headers });
  request = await res.json();
}

console.log(request.status, request.outputs[0]?.url);

import os
import requests

headers = {"Authorization": f"Bearer {os.environ['DOITONG_API_KEY']}"}
request = {"id": "req_8k2m4q7x1z9c3v5b6n0p2r4t", "status": "queued"}

while request["status"] in ("queued", "running"):
    request = requests.get(
        f"https://api.doitong.ru/v1/requests/{request['id']}",
        params={"wait": 20},
        headers=headers,
    ).json()

print(request["status"], request["outputs"][0]["url"] if request["outputs"] else None)

Wann status succeeded ass, enthält outputs[].url Linken op d'Dateien an eiser Späicherung. Wann d'Ufro failed oder canceled ass, ginn hir API-Kreditter automatesch rembourséiert an error erkläert firwat. Annuléiert alles, wat nach queued oder running ass:

Terminal

curl -X POST "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Bei laange Videojobs kënnt Dir d'Polling iwwersprangen an amplaz e webhook_url iwwerginn (kuckt Webhooks).

4. Dateien

Iwwergitt all ëffentlech URL als Input, oder frot POST /files no enger Upload-URL, maacht PUT op dës URL a benotzt déi zeréckginn file_url (kuckt Files). Eng erfollegräich Ufro list hir Resultater an outputs[] mat Typ, Inhaltstyp an, wa bekannt, Dimensiounen an Dauer op.

Terminal

curl -X POST "https://api.doitong.ru/v1/files" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"filename": "fox.jpg", "content_type": "image/jpeg", "size": 482113}'

Feeler

All Modell schléit op déiselwecht Aart aus: eng Enveloppe mat engem type, engem exakte code, dem problematesche param an all Problem an details, sou datt en Agent d'Ufro fixéiere kann, ouni Prosa ze liesen. Fir eng ongülteg Ufro gëtt näischt verrechent.

422 Unprocessable Entity

{
  "error": {
    "type": "invalid_request",
    "code": "invalid_input",
    "message": "duration must be one of 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15.",
    "param": "duration",
    "details": [ { "param": "duration", "message": "duration must be one of 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15." } ],
    "request_id": null,
    "doc_url": "https://doitong.com/developers/docs/errors#invalid_input"
  }
}

All Typ a Code sinn an Errors opgelëscht.

Präisser

Präisser sinn an USD an API-Kreditter a ginn op all Modell-Säit ugewisen, ier Dir leeft. All Ufro enthält cost mat credits, usd, charged an refunded. E Laf gëtt verrechent, wann en akzeptéiert gëtt; failed- an canceled-Ufroe ginn automatesch rembourséiert. E puer Modeller ginn genee no der Input präisgerechent, e puer no der Längt oder Gréisst vun den Dateien, déi Dir schéckt, anerer verrechnen en geschätzte Präis pro Laf: Egal wéi, d'Präisufro ass dat, wat Dir bezuelt. E puer Modeller (Sprooch- a Visiounsmodeller, Stëmm, Tools fir d'Veraarbechtungszäit) ginn no Notzung verrechent: d'Präisufro ass de Maximum, deen de Laf kaschte kann, an den Deel, deen de Laf net benotzt huet, gëtt automatesch rembourséiert. Kuckt Pricing.

MCP an AI-Agenten

Connectéiert all MCP-Client mat https://api.doitong.ru/v1/mcp mam selwechte Bearer-Schlëssel. Ären Agent kann de Katalog duerchsichen, Modeller präisufroen an ausféieren, an all Dokumentatiounssäit als Markdown liesen.

Claude Code

claude mcp add --transport http doitong-models https://api.doitong.ru/v1/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Nächst Schrëtt

Duerchsicht all Modeller. All Säit huet e Builder fir Ufroen, deen de Code fir Iech schreift.
Léiert de Liewenszyklus vun enger Ufro kennen: Requests.
Benotzt déiselwecht Parameternimm bei all Modell: Parameters.
Schafft Dir mat engem AI-Coding-Agent? Gitt him https://doitong.com/developers/llms.txt oder connectéiert de MCP-Server.

1. En API-Schlëssel kréien#

2. Präis ufroen, duerno ausféieren#

3. De Status verfollegen#

4. Dateien#

Feeler#

Präisser#

MCP an AI-Agenten#

Nächst Schrëtt#

1. En API-Schlëssel kréien

2. Präis ufroen, duerno ausféieren

3. De Status verfollegen

4. Dateien

Feeler

Präisser

MCP an AI-Agenten

Nächst Schrëtt