# Prisioedd

Mae pob model yn costio'n union yr hyn y mae gwneuthurwr y model yn ei godi amdano, mewn doleri'r UD. Rydych yn talu o'ch **balans API**,
sy'n cael ei gyfrif mewn **credydau API**: **1,000 o gredydau API = $1**. Mae balans API yn falans ar wahân, ar wahân i
gredydau apiau Doitong. Nid oes cynlluniau, isafswmau na ffioedd fesul model: mae galwad yn costio ei bris, wedi'i ddebydu o'r
balans API pan dderbynnir y cais.

Yn Rwsia (doitong.ru, api.doitong.ru, neu `?currency=rub`) dangosir prisiau hefyd mewn rubles: pris USD × cyfradd
USD/RUB × 1.3.

## Unedau

Mae gan bob model uned filio, a ddangosir ar ei dudalen ac yn `GET https://api.doitong.com/v1/models/{model_id}`:

| Uned | Nifer |
|---|---|
| `second` | Eiliadau o fideo neu sain allbwn (`duration`) |
| `image` | Delweddau a gynhyrchir (`num_images`) |
| `megapixel` | Lled × uchder yr allbwn, mewn megapicseli (1 MP = 1024 × 1024 picsel) |
| `video` | Un fideo a gynhyrchir |
| `request` | Un galwad |
| `1000_characters` | Nodau testun mewnbwn, fesul 1000 |
| `step` | Camau hyfforddi |

Pris = nifer × credydau API fesul uned, wedi'i dalgrynnu i fyny i gredyd API cyfan ($0.001), byth yn llai nag 1. Gall
unedau rhad iawn fod â phris ffracsiynol fesul uned (`0.4` credyd API fesul eiliad); dim ond cyfanswm galwad sy'n cael ei dalgrynnu.

Mae rhai modelau'n codi cyfradd wahanol yn dibynnu ar y mewnbwn: mae fideo â sain yn costio mwy na fideo heb sain, mae 4K yn costio mwy
na 1K, ac ati. Rhestrir y **rheolau** hyn ar dudalen pob model. Mae paramedr nad ydych yn ei gynnwys yn cyfrif fel ei werth rhagosodedig,
felly'r pris a welwch ar gyfer mewnbwn yw'r pris a dalwch.

## Prisiau cywir, mesuredig, amcangyfrifedig a phrisiau yn ôl defnydd

Mae gan bob pris `mode`:

- `exact`: cyfrifir y pris o'ch mewnbwn (eiliadau, delweddau, megapicseli, nodau, camau, neu un pris sefydlog fesul fideo neu alwad).
- `measured`: mae'r pris yn dilyn y ffeiliau a anfonwch: hyd fideo neu sain mewnbwn, maint delwedd mewnbwn, cyfradd fframiau neu nifer fframiau fideo. Caiff
  uwchraddio, cydamseru gwefusau, fideo-i-fideo, trawsgrifio ac offer sain eu prisio fel hyn. Cyn y rhediad mae'r API yn darllen hyd, cydraniad a chyfradd fframiau'r ffeil (mae'r dyfynbris yn gwneud yr un peth), felly'r dyfynbris yw union gost y rhediad. Mae tudalen y model yn dweud am beth rydych yn talu ("Pris fesul eiliad o'ch fideo mewnbwn") ac mae ei gyfrifiannell yn defnyddio rhifau eich ffeil. Gwrthodir ffeil na ellir ei darllen gyda `unmeasurable_input` ac ni chodir dim.
- `estimate`: mae cost y model ei hun yn dibynnu ar rywbeth na all y mewnbwn ei ddweud ymlaen llaw (tocynnau, amser cyfrifiadurol). Mae model o'r fath yn codi **pris amcangyfrifedig sefydlog fesul rhediad** (fesul delwedd allbwn pan fydd ganddo gyfrif delweddau), wedi'i osod o gost gyfartalog rhediadau go iawn y model hwnnw. Rydych yn gwybod y pris cyn rhedeg o hyd: y dyfynbris yw'r hyn a dalwch.
- `metered`: caiff y model ei **godi yn ôl y defnydd gwirioneddol**, a dim ond y rhediad ei hun sy'n ei wybod: y tocynnau y mae model iaith neu weledigaeth yn eu darllen a'u hysgrifennu, yr eiliadau o leferydd y mae model llais yn eu cynhyrchu, neu amser prosesu'r model. Gweler [Codir yn ôl y defnydd](#metered) isod.

Mae tudalennau modelau yn dweud "Pris fesul rhediad", "Pris fesul eiliad o'ch fideo mewnbwn" (a thermau tebyg), "Pris amcangyfrifedig fesul rhediad" neu "Codir yn ôl y defnydd"; mae `GET https://api.doitong.com/v1/models?mode=measured`, `?mode=estimate` a `?mode=metered` yn eu rhestru.

## Codir yn ôl y defnydd

Mae gan fodel `metered` bris defnydd ("$0.01 fesul 1000 tocyn", "$0.002 fesul eiliad o sain a gynhyrchir", "$0.00111 fesul
 eiliad o amser prosesu") a **uchafswm fesul rhediad**: y mwyaf y gall y rhediad ei gostio, yn seiliedig ar yr hyn y mae'ch cais yn ei ddweud
(`max_tokens`, hyd eich testun, y cydraniad, nifer yr allbynnau) a therfynau cyhoeddedig y model. Nid yw byth yn dibynnu ar gynnwys ffeil y tu ôl i URL. Ar gyfer model a filir yn ôl amser prosesu neu hyd sesiwn lais, yr uchafswm yw'r amser hiraf y gall cais redeg (15 munud ar gyfer delweddau, 30 ar gyfer sain, 60 ar gyfer fideo), felly mae ymhell uwchben rhediad arferol. Gwrthodir mewnbwn y byddai ei uchafswm uwchlaw terfyn fesul rhediad y model (testun hir iawn) gyda `422 invalid_input`:

1. Mae'r dyfynbris yn dychwelyd yr uchafswm hwnnw fel `credits` (gydag `hold` a `typical`, sef rhediad arferol). Pan fydd y rhediad yn cychwyn, debydir yr uchafswm o'r balans API, a dyma'r hyn y mae'n rhaid i'r balans a chyllideb eich allwedd ei dalu.
2. Pan fydd y rhediad yn llwyddo, setlir y cais i'r defnydd y mae'r model yn ei adrodd ar ei gyfer: defnydd × pris y defnydd, wedi'i dalgrynnu i fyny i gredyd API cyfan. **Ad-delir gweddill yr uchafswm yn awtomatig**, unwaith, fel rhes `refund` o'ch balans API.
3. Nid yw rhediad byth yn costio mwy na'i uchafswm, hyd yn oed pe bai ei ddefnydd yn gwneud hynny. Ad-delir rhediad a fethodd neu a ganslwyd yn llawn, fel bob amser.

Mae'r rhan fwyaf o rediadau'n costio llawer llai na'r uchafswm; mae tudalen y model yn dangos "Hyd at $X fesul rhediad" ar gyfer mewnbwn yr adeiladwr a'r rhediad arferol ("from" yn y catalog). Ar gyfer yr ychydig fodelau a filir yn ôl amser prosesu, defnydd yw amser prosesu'r model (wedi'i farcio
`approximate`).

```json 200 OK · dyfynbris model sy'n cael ei godi yn ôl y defnydd
{
  "object": "quote",
  "credits": 621,
  "usd": "0.621",
  "mode": "metered",
  "label": "Charged by usage",
  "hold": { "credits": 621, "usd": "0.621" },
  "typical": { "credits": 10, "usd": "0.01" },
  "settlement": "usage",
  "display": "$0.01 / 1000 tokens",
  "breakdown": "up to 62.035 × 1000 tokens × $0.01"
}
```

Ar ôl y rhediad, mae `cost` y cais yn dangos beth a ddaliwyd a beth oedd y defnydd:

```json
{
  "cost": { "credits": 621, "usd": "0.621", "charged": 621, "refunded": 611, "mode": "metered", "held": 621,
            "typical": 10, "settled": { "status": "settled", "credits": 10, "usd": "0.01", "quantity": 1,
            "unit": "1000_tokens", "unit_usd": "0.01", "source": "billed_usage", "approximate": false } }
}
```

`charged − refunded` yw cost y rhediad. Mae `settled.status` yn `pending` am y foment rhwng y canlyniad a'r setliad, ac yn `no_usage` yn yr achos prin na adroddodd y model am unrhyw ddefnydd o gwbl (yna yr uchafswm sy'n parhau fel y pris).

## Dyfynbris cyn rhedeg

Mae `POST https://api.doitong.com/v1/quote/{model_id}` yn cymryd union gorff y byddech yn ei anfon at `run` ac yn dychwelyd pris y mewnbwn hwnnw: y pris cywir, ac eithrio model [sy'n cael ei godi yn ôl y defnydd](#metered), lle mai hwn yw'r mwyaf y gall y rhediad ei gostio. Nid oes angen allwedd arno ac nid yw'n costio dim:

```bash
curl -X POST "https://api.doitong.com/v1/quote/flux/schnell" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "A lighthouse at dusk", "num_images": 2}'
```

```json 200 OK · dyfynbris
{
  "object": "quote",
  "model": "flux/schnell",
  "credits": 6,
  "usd": "0.006",
  "unit": "megapixel",
  "quantity": 2,
  "unit_credits": 3,
  "mode": "exact",
  "label": "Price per run",
  "display": "$0.003 / megapixel",
  "breakdown": "2 MP (2 images) × 3 API credits",
  "input": { "prompt": "A lighthouse at dusk", "num_images": 2 },
  "warnings": []
}
```

Gydag allwedd, mae'r dyfynbris hefyd yn dychwelyd `balance_credits` a `balance_usd` (eich balans API), `affordable` a
`key_budget_remaining`. Ychwanegwch `?currency=rub` am swm `rub`.

> [!TIP]
> **Y dyfynbris yw'r tâl.** Mae'r un ffwythiant yn cyfrifo'r ddau, felly mae rhediad gyda'r mewnbwn hwn yn costio union `credits`.
> Yr unig eithriad yw model [sy'n cael ei godi yn ôl y defnydd](#metered) (`mode: metered`): yno `credits` yw'r mwyaf y gall y rhediad ei gostio,
> wedi'i ddebydu pan fydd yn cychwyn, ac ad-delir y rhan nas defnyddiwyd ar ôl y rhediad.

## Gwrthrychau pris

Mae gan bob pris yn yr API yr un siâp:

- models: `price: { "credits": 112, "usd": "0.112", "unit": "second", "display": "$0.112 / second",
  "credits_display": "112 API credits / second", "from_credits": 560, "from_usd": "0.56", "mode": "exact" }` — ynghyd â `rub`,
  `rub_display` a `from_rub` yn Rwsia neu gyda `?currency=rub`;
- requests: `cost: { "credits": 560, "usd": "0.56", "charged": 560, "refunded": 0 }` (credydau API; mae cais sy'n cael ei godi yn ôl y defnydd
  yn ychwanegu `mode`, `held`, `typical` a `settled`, gweler [Codir yn ôl y defnydd](#metered));
- account: mae `GET https://api.doitong.com/v1/account` yn dychwelyd `credits` (y balans API), `balance: { "credits", "usd" }` a
  `storage` (pris storio ffeiliau, defnydd ac amcangyfrif misol).

## Ad-daliadau

- Nid yw cais annilys (unrhyw `4xx` cyn i'r rhediad gychwyn) byth yn cael ei godi.
- Ad-delir cais sy'n gorffen yn `failed` (gan gynnwys `timeout`) yn llawn i'r balans API, yn awtomatig.
- Ad-delir cais rydych yn ei ganslo cyn iddo gychwyn yn llawn. Unwaith y mae'r model yn cynhyrchu, dim ond cais yw canslo: os bydd y model yn gorffen, caiff y canlyniad ei gyflwyno a chodir tâl.
- Mae cais `metered` sy'n llwyddo yn cael y rhan o'i uchafswm na ddefnyddiodd yn ôl.

Mae gwrthrych y cais yn dangos y cyfan: `cost.credits`, `cost.charged` a `cost.refunded`.

## Storio ffeiliau

Cedwir ffeiliau allbwn ar ein storfa. Rydych yn dewis, yn y cyfrif neu fesul rhediad (`?storage=`):

| | Cedwir | Pris |
|---|---|---|
| Am byth (`permanent`, rhagosodedig) | Hyd nes i chi eu dileu | 100 credydau API ($0.10) fesul GB y mis |
| 7 diwrnod (`temporary`) | 7 diwrnod | Am ddim |

Codir tâl am storio parhaol unwaith y dydd o'r balans API: GB a gedwir × y pris misol ÷ nifer y diwrnodau yn y mis, fel rhesi cyfriflyfr o fath `storage`. Trosglwyddir ffracsiynau credyd API i'r diwrnod nesaf, felly mae mis yn adio i union
GB × 100 credydau API (1 GB = 1024³ beit; mae 10 GB a gedwir am fis yn costio
1,000 credydau API). Nid yw'r balans byth yn mynd o dan sero: pan na all dalu, ni chodir tâl am y diwrnod hwnnw,
cewch e-bost, ac mae gennych 30 diwrnod i wneud ychwanegiad cyn i'r ffeiliau a gedwir ddod yn rhai dros dro a chael eu dileu 7 diwrnod yn ddiweddarach. Manylion: [Ffeiliau](https://doitong.com/developers/docs/files#storage).

## Prisiau cyfredol

| Model | ID | Pris | O |
|---|---|---|---|
| [FLUX.1 \[dev\]](https://doitong.com/developers/models/flux/dev) | `flux/dev` | $0.025 / megapicsel | $0.025 (25 o gredydau API) |
| [FLUX.1 \[schnell\]](https://doitong.com/developers/models/flux/schnell) | `flux/schnell` | $0.003 / megapicsel | $0.003 (3 o gredydau API) |
| [FLUX.2 \[dev\]](https://doitong.com/developers/models/flux-2) | `flux-2` | $0.012 / megapicsel | $0.012 (12 o gredydau API) |
| [FLUX.2 \[pro\]](https://doitong.com/developers/models/flux-2-pro) | `flux-2-pro` | $0.015 / megapicsel o ddelwedd allbwn | $0.015 (15 o gredydau API) |
| [GPT Image 2.5 Text to Image](https://doitong.com/developers/models/openai/gpt-image-2.5/flare/text-to-image) | `openai/gpt-image-2.5/flare/text-to-image` | o $0.008 / delwedd | $0.008 (8 o gredydau API) |
| [Ideogram V4.5](https://doitong.com/developers/models/ideogram/v4.5) | `ideogram/v4.5` | o $0.03 / delwedd | $0.03 (30 o gredydau API) |
| [Nano Banana 2](https://doitong.com/developers/models/nano-banana-2) | `nano-banana-2` | o $0.06 / delwedd | $0.06 (60 o gredydau API) |
| [Nano Banana Pro](https://doitong.com/developers/models/nano-banana-pro) | `nano-banana-pro` | o $0.15 / delwedd | $0.15 (150 o gredydau API) |
| [Qwen Image 3 Text to Image](https://doitong.com/developers/models/alibaba/qwen-image-3/text-to-image) | `alibaba/qwen-image-3/text-to-image` | o $0.04 / delwedd | $0.04 (40 o gredydau API) |
| [Recraft V4.1 Text to Image](https://doitong.com/developers/models/recraft/v4.1/text-to-image) | `recraft/v4.1/text-to-image` | $0.035 / delwedd | $0.035 (35 o gredydau API) |
| [Seedream 5.0 Pro Text to Image](https://doitong.com/developers/models/bytedance/seedream/v5/pro/text-to-image) | `bytedance/seedream/v5/pro/text-to-image` | o $0.068 | $0.068 (68 o gredydau API) |
| [FLUX.1 Kontext \[pro\]](https://doitong.com/developers/models/flux-pro/kontext) | `flux-pro/kontext` | $0.04 / delwedd | $0.04 (40 o gredydau API) |
| [Nano Banana 2 Edit](https://doitong.com/developers/models/nano-banana-2/edit) | `nano-banana-2/edit` | o $0.06 / delwedd | $0.06 (60 o gredydau API) |
| [Nano Banana Pro Edit](https://doitong.com/developers/models/nano-banana-pro/edit) | `nano-banana-pro/edit` | o $0.15 / delwedd | $0.15 (150 o gredydau API) |
| [Qwen Image 3 Edit](https://doitong.com/developers/models/alibaba/qwen-image-3/edit) | `alibaba/qwen-image-3/edit` | o $0.04 / delwedd | $0.04 (40 o gredydau API) |
| [FLUX 3 Max Text to Video](https://doitong.com/developers/models/blackforestlabs/flux-3-max/text-to-video) | `blackforestlabs/flux-3-max/text-to-video` | o $0.0425 / eiliad o fideo allbwn | $0.043 (43 o gredydau API) |
| [Grok Imagine Video 1.5 Text to Video](https://doitong.com/developers/models/xai/grok-imagine-video/v1.5/text-to-video) | `xai/grok-imagine-video/v1.5/text-to-video` | o $0.08 / eiliad | $0.48 (480 o gredydau API) |
| [Kling 3.0 Pro Text to Video](https://doitong.com/developers/models/kling-video/v3/pro/text-to-video) | `kling-video/v3/pro/text-to-video` | o $0.112 / eiliad | $0.56 (560 o gredydau API) |
| [LTX 2.5 Pro Text to Video](https://doitong.com/developers/models/lightricks/ltx-2.5/text-to-video/pro) | `lightricks/ltx-2.5/text-to-video/pro` | o $0.12 / eiliad | $0.72 (720 o gredydau API) |
| [MiniMax H3 Text to Video](https://doitong.com/developers/models/minimax/h3/text-to-video) | `minimax/h3/text-to-video` | o $0.05 / eiliad | $0.25 (250 o gredydau API) |
| [Seedance 2.0 Fast Text to Video](https://doitong.com/developers/models/bytedance/seedance-2.0/fast/text-to-video) | `bytedance/seedance-2.0/fast/text-to-video` | o $0.113 / eiliad | $0.452 (452 o gredydau API) |
| [Seedance 2.0 Text to Video](https://doitong.com/developers/models/bytedance/seedance-2.0/text-to-video) | `bytedance/seedance-2.0/text-to-video` | o $0.141 / eiliad | $0.564 (564 o gredydau API) |
| [Veo 3.1](https://doitong.com/developers/models/veo3.1) | `veo3.1` | o $0.20 / eiliad | $1.60 (1,600 o gredydau API) |
| [Veo 3.1 Fast](https://doitong.com/developers/models/veo3.1/fast) | `veo3.1/fast` | o $0.10 / eiliad | $0.80 (800 o gredydau API) |
| [Wan 3.0 Text to Video](https://doitong.com/developers/models/alibaba/wan-3.0/text-to-video) | `alibaba/wan-3.0/text-to-video` | o $0.05 / eiliad | $0.25 (250 o gredydau API) |
| [FLUX 3 Max Image to Video](https://doitong.com/developers/models/blackforestlabs/flux-3-max/image-to-video) | `blackforestlabs/flux-3-max/image-to-video` | o $0.0425 / eiliad o fideo allbwn | $0.043 (43 o gredydau API) |
| [Grok Imagine Video 1.5 Image to Video](https://doitong.com/developers/models/xai/grok-imagine-video/v1.5/image-to-video) | `xai/grok-imagine-video/v1.5/image-to-video` | o $0.082 / eiliad | $0.492 (492 o gredydau API) |
| [Kling 3.0 Pro Image to Video](https://doitong.com/developers/models/kling-video/v3/pro/image-to-video) | `kling-video/v3/pro/image-to-video` | o $0.112 / eiliad | $0.56 (560 o gredydau API) |
| [LTX 2.5 Pro Image to Video](https://doitong.com/developers/models/lightricks/ltx-2.5/image-to-video/pro) | `lightricks/ltx-2.5/image-to-video/pro` | o $0.12 / eiliad | $0.72 (720 o gredydau API) |
| [MiniMax H3 Image to Video](https://doitong.com/developers/models/minimax/h3/image-to-video) | `minimax/h3/image-to-video` | o $0.05 / eiliad | $0.25 (250 o gredydau API) |
| [Seedance 2.0 Fast Image to Video](https://doitong.com/developers/models/bytedance/seedance-2.0/fast/image-to-video) | `bytedance/seedance-2.0/fast/image-to-video` | o $0.113 / eiliad | $0.452 (452 o gredydau API) |
| [Seedance 2.0 Image to Video](https://doitong.com/developers/models/bytedance/seedance-2.0/image-to-video) | `bytedance/seedance-2.0/image-to-video` | o $0.141 / eiliad | $0.564 (564 o gredydau API) |
| [Veo 3.1 Fast Image to Video](https://doitong.com/developers/models/veo3.1/fast/image-to-video) | `veo3.1/fast/image-to-video` | o $0.10 / eiliad | $0.80 (800 o gredydau API) |
| [Veo 3.1 Image to Video](https://doitong.com/developers/models/veo3.1/image-to-video) | `veo3.1/image-to-video` | o $0.20 / eiliad | $1.60 (1,600 o gredydau API) |
| [Wan 3.0 Image to Video](https://doitong.com/developers/models/alibaba/wan-3.0/image-to-video) | `alibaba/wan-3.0/image-to-video` | o $0.05 / eiliad | $0.25 (250 o gredydau API) |
| [Seedance 2.0 Fast Reference to Video](https://doitong.com/developers/models/bytedance/seedance-2.0/fast/reference-to-video) | `bytedance/seedance-2.0/fast/reference-to-video` | o $0.113 / eiliad | $0.452 (452 o gredydau API) |
| [Seedance 2.0 Reference to Video](https://doitong.com/developers/models/bytedance/seedance-2.0/reference-to-video) | `bytedance/seedance-2.0/reference-to-video` | o $0.141 / eiliad | $0.564 (564 o gredydau API) |
| [Kling AI Avatar 2.0 Pro](https://doitong.com/developers/models/kling-video/ai-avatar/v2/pro) | `kling-video/ai-avatar/v2/pro` | $0.115 / eiliad o sain mewnbwn | $0.115 (115 o gredydau API) |
| [Sync Lipsync 3](https://doitong.com/developers/models/sync-lipsync/v3) | `sync-lipsync/v3` | $8.00 / munud o fideo allbwn | $8.00 (8,000 o gredydau API) |
| [VEED Fabric 1.0](https://doitong.com/developers/models/veed/fabric-1.0) | `veed/fabric-1.0` | o $0.08 / eiliad o sain mewnbwn | $0.08 (80 o gredydau API) |
| [Topaz Image Upscale](https://doitong.com/developers/models/topaz/upscale/image/precision) | `topaz/upscale/image/precision` | $0.08 / 24 megapicsel o ddelwedd allbwn | $0.08 (80 o gredydau API) |
| [Topaz Video Upscale](https://doitong.com/developers/models/topaz/upscale/video/precision) | `topaz/upscale/video/precision` | o $0.00667 / eiliad o fideo mewnbwn | $0.10 (100 o gredydau API) |
| [Bria RMBG 2.0](https://doitong.com/developers/models/bria/background/remove) | `bria/background/remove` | o $0.018 | $0.018 (18 o gredydau API) |
| [Eleven v4 Text to Speech](https://doitong.com/developers/models/elevenlabs/tts/eleven-v4) | `elevenlabs/tts/eleven-v4` | $0.08 / 1000 nod | $0.08 (80 o gredydau API) |
| [MiniMax Speech 2.8 HD](https://doitong.com/developers/models/minimax/speech-2.8-hd) | `minimax/speech-2.8-hd` | $0.10 / 1000 nod | $0.10 (100 o gredydau API) |
| [MiniMax Music 3](https://doitong.com/developers/models/minimax/music-3) | `minimax/music-3` | $0.002 / eiliad | $0.12 (120 o gredydau API) |
| [MMAudio V2](https://doitong.com/developers/models/mmaudio-v2) | `mmaudio-v2` | $0.001 / eiliad | $0.008 (8 o gredydau API) |

Dyma'r modelau dan sylw. Mae'r holl 1,496 o fodelau a'u prisiau yn y [catalog modelau](https://doitong.com/developers/models) ac yn `GET /models` (nid oes angen allwedd).

## Ychwanegu at y balans

Ychwanegwch arian at y balans API yn [https://doitong.com/developers/dashboard#balance](https://doitong.com/developers/dashboard#balance). Pan fo'r balans yn rhy isel, mae rhediad yn ateb
`402 insufficient_credits` gyda `top_up_url`. Gellir hefyd osod terfyn ar bob allwedd API gyda'i chyllideb ei hun mewn credydau API
(gweler [Dilysu](https://doitong.com/developers/docs/authentication#credit-budgets)).