Komast af stað

Hraðbyrjun

Skoða sem Markdown Uppfært 2026-10-22

Keyrðu fyrstu efnisgerðina þína á nokkrum mínútum. Öll 1.496 líkön taka við sömu tegund beiðni og skila sama beiðnihlutnum fyrir myndir, myndbönd og hljóð: lærðu þetta einu sinni hér.

1. Fáðu API-lykil

Búðu til lykil á https://doitong.com/developers/dashboard#keys og geymdu hann í umhverfisbreytu: hann birtist aðeins einu sinni. Hver lykill getur haft sinn eigin fjárhagsramma, svo þú getur afhent hann gervigreindarforriti án þess að hætta á öllum reikningnum. GET /account skilar API-stöðunni þinni.

export DOITONG_API_KEY="doitong_..."

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

const res = await fetch("https://api.doitong.com/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.com/v1/account",
    headers={"Authorization": f"Bearer {os.environ['DOITONG_API_KEY']}"},
)
print(r.json())

Keyrslur eru greiddar af API-stöðu reikningsins þíns í API-inneign: 1.000 API-inneignir = 1 $, og hvert líkan kostar nákvæmlega verð framleiðanda þess. Gerðu áfyllingu á https://doitong.com/developers/dashboard#balance.

2. Fáðu verðtilboð og keyrðu síðan

POST /quote/{model_id} tekur við inntaks-JSON og skilar nákvæmu verði. Það þarf engan lykil og kostar ekkert. Sama inntak kostar nákvæmlega það: verðtilboðið er gjaldið. (Undantekningin er líkan sem rukkar eftir notkun: verðtilboðið er hæsta upphæðin sem keyrslan getur kostað og ónotaði hlutinn er endurgreiddur eftir keyrsluna.)

curl -X POST "https://api.doitong.com/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.com/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.com/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 · verðtilboð

{
  "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"
}

Sendu síðan sama meginmál á POST /run/{model_id}. Bættu við ?wait=20 til að halda tengingunni opinni í allt að 20 sekúndur: hratt líkan skilar fullunninni niðurstöðu í einni umferð. Sendu Idempotency-Key-haus svo endurtekning keyri aldrei (eða rukki) tvisvar.

curl -X POST "https://api.doitong.com/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.com/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.com/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)

Svarið er beiðnihlutur:

200 OK · beiðni

{
  "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. Fylgstu með stöðunni

Ef líkanið er enn að vinna þegar biðtímanum lýkur færðu 202 Accepted með id beiðninnar og núverandi status. Hver beiðni fer í gegnum sama lífsferli:

Lífsferill beiðni

queued Samþykkt og gjaldfært, bíður starfsmanns
running Líkanið er að búa til úttakið
Lokastaðal:
- succeededTilvitnað verð gjaldfært; outputs[] inniheldur URL í geymsluna okkar
- failedEndurgreitt sjálfkrafa; villan útskýrir ástæðuna
- canceledStöðvað áður en niðurstaða fékkst; endurgreitt

Lestu beiðnina aftur með auðkenni hennar. ?wait=20 virkar einnig hér, svo einföld lykkja dugar:

curl "https://api.doitong.com/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.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t?wait=20", { headers })).json();

while (request.status === "queued" || request.status === "running") {
  const res = await fetch(`https://api.doitong.com/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.com/v1/requests/{request['id']}",
        params={"wait": 20},
        headers=headers,
    ).json()

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

Þegar status er succeeded geymir outputs[].url tengla á skrárnar í geymslunni okkar. Ef beiðnin failed eða var canceled eru API-inneignir hennar endurgreiddar sjálfkrafa og error segir hvers vegna. Hættu við allt sem er enn queued eða running:

skipanalína

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

Fyrir löng myndbandsverk geturðu sleppt könnun og sent þess í stað webhook_url (sjá vefkróka).

4. Skrár

Sendu hvaða opinbera slóð sem er sem inntak, eða biddu POST /files um upphleðsluslóð, PUT-aðu skránni þangað og notaðu file_url sem skilað er (sjá skrár). Beiðni sem tókst listar niðurstöður sínar í outputs[] með tegund, efnistegund og, þegar það er þekkt, málum og lengd.

skipanalína

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

Villur

Öll líkön bila á sama hátt: einn umbúnaður með type, nákvæmu code, vandræðafæribreytunni param og öllum vandamálum í details, svo gervigreindarforrit geti lagað beiðnina án þess að lesa texta. Ógild beiðni er aldrei rukkuð.

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"
  }
}

Allar tegundir og kóðar eru taldir upp í villum.

Verðlagning

Verð eru í USD og API-inneignum og birtast á síðu hvers líkans áður en þú keyrir það. Hver beiðni inniheldur cost með credits, usd, charged og refunded. Keyrsla er rukkuð þegar hún er samþykkt; failed og canceled beiðnir eru endurgreiddar sjálfkrafa. Sum líkön eru verðlögð nákvæmlega út frá inntakinu, sum eftir lengd eða stærð skráanna sem þú sendir, en önnur rukka áætlað verð fyrir hverja keyrslu: hvað sem því líður er verðtilboðið það sem þú greiðir. Nokkur líkön (tungumála- og myndgreiningarlíkön, radd- og úrvinnslutímatól) eru rukkuð eftir notkun: verðtilboðið er hæsta upphæðin sem keyrslan getur kostað og sá hluti sem keyrslan notaði ekki er endurgreiddur sjálfkrafa. Sjá verðlagningu.

MCP og gervigreindarforrit

Tengdu hvaða MCP-biðlara sem er við https://api.doitong.com/v1/mcp með sama Bearer-lykli. Gervigreindarforritið þitt getur leitað í vörulistanum, fengið verðtilboð í og keyrt líkön og lesið allar skjálsíður sem Markdown.

Claude Code

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

Næstu skref

Skoðaðu öll líkön. Á hverri síðu er beiðnismiði sem skrifar kóðann fyrir þig.
Lærðu lífsferil beiðna: beiðnir.
Notaðu sömu færibreytuheiti fyrir öll líkön: færibreytur.
Ertu að vinna með gervigreindarforriti fyrir kóðun? Gefðu því https://doitong.com/developers/llms.txt eða tengdu MCP-þjóninn.

1. Fáðu API-lykil#

2. Fáðu verðtilboð og keyrðu síðan#

3. Fylgstu með stöðunni#

4. Skrár#

Villur#

Verðlagning#

MCP og gervigreindarforrit#

Næstu skref#

1. Fáðu API-lykil

2. Fáðu verðtilboð og keyrðu síðan

3. Fylgstu með stöðunni

4. Skrár

Villur

Verðlagning

MCP og gervigreindarforrit

Næstu skref