A’ tòiseachadh

Tòiseachadh luath

Seall mar Markdown Air ùrachadh 2026-10-22

Ruith a’ chiad ghineadh agad ann am beagan mhionaidean. Bidh an aon seòrsa iarrtais aig na 1,496 modalan uile agus tillidh iad an aon nì iarrtais, airson ìomhaighean, bhidio agus claisneachd: ionnsaich e aon turas an seo.

1. Faigh iuchair API

Cruthaich iuchair aig https://doitong.com/developers/dashboard#keys agus cumaibh i ann an caochladair àrainneachd: cha nochd i ach aon turas. Faodaidh a bhuidseat fhèin a bhith aig gach iuchair, mar sin faodaidh tu tè a thoirt do dh’àidseant gun an cunntas air fad a chur ann an cunnart. Tillidh GET /account iarmad an API agad.

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())

Tha ruith air am pàigheadh à iarmad API a’ chunntais agad ann an creideasan API: 1,000 creideasan API = $1, agus cosgaidh gach modail prìs an neach-dèanaimh aige gu mionaideach. Cuir cur-ris ris aig https://doitong.com/developers/dashboard#balance.

2. Faigh luachan, agus ruith an uair sin

Gabhaidh POST /quote/{model_id} an JSON in-chuir agus tillidh e a’ phrìs cheart. Chan eil iuchair a dhìth air agus chan eil cosgais ann. Cosgaidh ruith leis an aon in-chur dìreach an luach sin: ’s e an luachan a’ chosgais. (Tha modail a thèid a chìseanachadh a rèir cleachdaidh na eisgeachd: ’s e an luachan an ìre as motha a dh’fhaodas an ruith a chosg, agus thèid a’ chuibhreann nach deach a chleachdadh ath-phàigheadh an dèidh an ruith.)

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 · luachan

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

An uair sin cuir an aon bhodhaig gu POST /run/{model_id}. Cuir ?wait=20 ris gus an ceangal a chumail fosgailte airson suas ri 20 diog: tillidh modail luath an toradh chrìochnaichte ann an aon chuairt. Cuir bann-cinn Idempotency-Key gus nach ruith (no nach cuir cosgais air) ath-iarrtas dà thuras.

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)

’S e nì iarrtais a th’ anns an fhreagairt:

200 OK · iarrtas

{
  "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. Lean an inbhe

Ma tha am modail fhathast ag obair nuair a thig an ùine feitheimh gu crìch, gheibh thu 202 Accepted leis an id aig an iarrtas agus an status làithreach aige. Bidh gach iarrtas a’ dol tron aon chuairt-beatha:

Cuairt-beatha an iarrtais

queued Air gabhail ris agus air a ghearradh, a’ feitheamh ri neach-obrach
running Tha am modail a’ gineadh
Inbhean deireannach:
- succeededChaidh an cuòt a chur fo chìs; tha URLs air an stòras againn ann an outputs[]
- failedAir a phàigheadh air ais gu fèin-obrachail; tha am mearachd ag innse carson
- canceledAir a stad mus robh toradh ann; air a phàigheadh air ais

Leugh an iarrtas a-rithist leis an id aige. Obraichidh ?wait=20 an seo cuideachd, agus mar sin tha lùb shìmplidh gu leòr:

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)

Nuair a tha status aig succeeded, bidh outputs[].url a’ cumail cheanglaichean gu na faidhlichean air an stòradh againn. Ma tha an iarrtas failed no canceled, thèid na creideasan API aige ath-phàigheadh gu fèin-obrachail agus innsidh error carson. Sguir de rud sam bith a tha fhathast queued no running:

uidhe ⚠️

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

Airson obraichean bhidio fada faodaidh tu stad a chur air bhòtadh agus webhook_url a chur seachad na àite (faic Webhooks).

4. Faidhlichean

Cuir URL poblach sam bith seachad mar in-chur, no iarr URL luchdaidh suas le POST /files, cuir PUT air an fhaidhle an sin agus cleachd an file_url a thillear (faic Files). Tha iarrtas soirbheachail a’ liostadh a thoraidhean ann an outputs[] le type, content type agus, nuair a tha fios orra, tomhasan agus fad.

uidhe ⚠️

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

Mearachdan

Bidh gach modail a’ fàiligeadh san aon dòigh: aon chèis le type, code cheart, am param a dh’adhbhraich an duilgheadas agus gach duilgheadas ann an details, gus an urrainn do dh’àidseant an iarrtas a cheartachadh gun phròs a leughadh. Cha tèid cosgais a chur air iarrtas mì-dhligheach.

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

Tha gach type agus code air an liostadh ann an Errors.

Prìsean

Tha prìsean ann an USD agus creideasan API agus air an sealltainn air duilleag gach modail mus ruith thu e. Bidh cost aig gach iarrtas le credits, usd, charged agus refunded. Thèid cosgais a chur air ruith nuair a thèid gabhail ris; thèid iarrtasan failed agus canceled ath-phàigheadh gun fèin-obrachail. Tha cuid de mhodalan air am prìseachadh dìreach bhon in-chur, cuid a rèir fad no meud nam faidhlichean a chuireas tu, agus cuid eile a’ cur cosgais air prìs mheasta gach ruith: co-dhiù, ’s e an luachan na phàigheas tu. Tha beagan mhodalan (modalan cànain agus lèirsinn, guth, innealan ùine-giullachd) air an cosgais a rèir cleachdaidh: ’s e an luachan an ìre as motha a dh’fhaodas an ruith a chosg, agus thèid an chuibhreann nach do chleachd an ruith ath-phàigheadh gu fèin-obrachail. Faic Pricing.

MCP agus àidseantan AI

Ceangail cliant MCP sam bith ri https://api.doitong.com/v1/mcp leis an aon iuchair Bearer. Faodaidh an t-àidseant agad an catalog a rannsachadh, luachan fhaighinn agus modalan a ruith, agus gach duilleag sgrìobhainnean a leughadh mar Markdown.

Claude Code

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

Na h-ath cheumannan

Rannsaich na modailean uile. Tha togail-iarrtais air gach duilleag a sgrìobhas an còd dhut.
Ionnsaich cearcall-beatha an iarrtais: Requests.
Cleachd na h-aon ainmean paramadair air gach modail: Parameters.
Ag obair le àidseant còdaidh AI? Thoir dha https://doitong.com/developers/llms.txt no ceangail am frithealaiche MCP.

1. Faigh iuchair API#

2. Faigh luachan, agus ruith an uair sin#

3. Lean an inbhe#

4. Faidhlichean#

Mearachdan#

Prìsean#

MCP agus àidseantan AI#

Na h-ath cheumannan#

1. Faigh iuchair API

2. Faigh luachan, agus ruith an uair sin

3. Lean an inbhe

4. Faidhlichean

Mearachdan

Prìsean

MCP agus àidseantan AI

Na h-ath cheumannan