Leum chun t-susbaint

ACE Step

Amalaich

ID a’ mhodail ace-step
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/ace-step?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tags": "lofi, hiphop, drum and bass, trap, chill"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

An t-iarrtas seo: $0.012 12 creideasan API Ruith e air an duilleig seo

Faigh iuchair API
ACE Studio Teacsa gu Ceòl 5–240 s #text-to-audio#text-to-music

A’ cur ceòl ri chèile bho tagaichean gnè agus briathran roghainneil, le fad 5 gu 240 diog

ACE Studio · Fuaim

Thèid a’ chiad toradh agad an-seo

Tog iarrtas gu h-ìosal agus ruith e leis an iuchair API agad. Tha na h-às-churan air an lethbhreacadh dhan stòradh againn, air an cumail gu bràth no 7 latha an-asgaidh.

Tog iarrtas

Tha na smachdan air an cruthachadh bho sgeama a’ mhodail. Bidh an còd agus a’ phrìs ag ùrachadh fhad ’s a dh’atharraicheas tu iad.

•riatanach

Tagaichean stoidhle claisneachd air an solar mar ghnèithean sgaraichte le cromagan, le `prompt` ri fhaighinn mar dhòigh eile air an solar.

bun-roghainn 60

Fad na claisneachd a chaidh a ghineadh, ann an diogan.

Adhartach lyrics · scheduler · guidance_type · number_of_steps · granularity_scale · guidance_interval · guidance_interval_decay · guidance_scale · minimum_guidance_scale · tag_guidance_scale · lyric_guidance_scale · seed
bun-roghainn

Lìrics sheinnte, le earrannan na h-òrain air an eagrachadh le smachdan leithid [verse], [chorus] agus [bridge]. Airson claisneachd gun l tomaics sheinnte, fàg an in-chur seo air falbh no solar dìreach [inst] no [instrumental].

scheduler bun-roghainn euler

Clàr-ama a thèid a chleachdadh rè gineadh.

guidance_type bun-roghainn apg

Seòrsa CFG a thèid a chleachdadh rè gineadh.

bun-roghainn 27

Àireamh nan ceumannan a thèid a chleachdadh rè gineadh na claisneachd.

bun-roghainn 10

Sgèile granularity a thèid a chur an sàs rè gineadh. Dh’fhaodadh àrdachadh air lùghdachadh a dhèanamh air nithean fuadain.

bun-roghainn 0.5

A’ chuibhreann de chlàr-ama a’ ghineadh a gheibh stiùireadh: le bhith a’ taghadh 0.5, tha e air a chuingealachadh ri ceumannan bho 0.25 * infer_steps tro 0.75 * infer_steps, a’ fàgail an toiseach agus an deireadh gun stiùireadh.

bun-roghainn 0

Lùghdachadh stiùiridh taobh a-staigh na h-ùine gineadh: cumaidh 0.0 lùghdachadh à comas; air dhòigh eile, lùghdaichidh an sgèile thar na h-ùine sin bho guidance_scale gu min_guidance_scale.

bun-roghainn 15

Sgèile an stiùiridh a thèid a chur an sàs rè gineadh.

bun-roghainn 3

An sgèile stiùiridh as ìsle a ruigear às dèidh lùghdachadh rè gineadh.

bun-roghainn 5

Sgèile stiùiridh nan tagaichean a thèid a chur an sàs rè gineadh.

bun-roghainn 1.5

Sgèile stiùiridh nan l lyrics a thèid a chur an sàs rè gineadh.

Sìol airson gineadh ath-riochdachail, air a thaghadh air thuaiream mura solar thu luach.

POST /run/ace-step?wait=20 tuairmse → $0.012
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/ace-step?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tags": "lofi, hiphop, drum and bass, trap, chill"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Ruith an t-iarrtas seo

Fuirichidh an iuchair agad sa bhrobhsair seo: thèid a cur chun Doitong API a-mhàin agus a sàbhaladh (localStorage) a-mhàin ma chuireas tu comharra ri Cuimhnich. Faigh iuchair API

Mu ACE Step

A’ cruthachadh slighe chiùil bho `tags` stoidhle air an sgaradh le cromagan agus `lyrics` roghainneil. Bidh comharran earrannan mar [verse] agus [chorus] a’ cumadh structar an òrain, agus bidh [inst] a’ toirt seachad ceòl ionnsramaideach. Tha `duration` eadar 5 agus 240 diog. Tha smachdan samplachaidh a’ gabhail a-steach `scheduler` (euler no heun), `guidance_type`, agus `number_of_steps` eadar 3 agus 60.

Paramadairean

AinmSeòrsa Bun-roghainnCeadaichte Tuairisgeul
tagsriatanach
Seòrsastring
Tagaichean stoidhle claisneachd air an solar mar ghnèithean sgaraichte le cromagan, le `prompt` ri fhaighinn mar dhòigh eile air an solar.
lyricsroghainneil
Seòrsastring
Bun-roghainn
Lìrics sheinnte, le earrannan na h-òrain air an eagrachadh le smachdan leithid [verse], [chorus] agus [bridge]. Airson claisneachd gun l tomaics sheinnte, fàg an in-chur seo air falbh no solar dìreach [inst] no [instrumental].
durationroghainneil
Seòrsanumber
Bun-roghainn60
5 – 240
Fad na claisneachd a chaidh a ghineadh, ann an diogan.
number_of_stepsroghainneil
Seòrsainteger
Bun-roghainn27
3 – 60
Àireamh nan ceumannan a thèid a chleachdadh rè gineadh na claisneachd.
seedroghainneil
Seòrsainteger | null
Sìol airson gineadh ath-riochdachail, air a thaghadh air thuaiream mura solar thu luach.
schedulerroghainneil
Seòrsaenum
Bun-roghainneuler
eulerheun
Clàr-ama a thèid a chleachdadh rè gineadh.
guidance_typeroghainneil
Seòrsaenum
Bun-roghainnapg
cfgapgcfg_star
Seòrsa CFG a thèid a chleachdadh rè gineadh.
granularity_scaleroghainneil
Seòrsainteger
Bun-roghainn10
-100 – 100
Sgèile granularity a thèid a chur an sàs rè gineadh. Dh’fhaodadh àrdachadh air lùghdachadh a dhèanamh air nithean fuadain.
guidance_intervalroghainneil
Seòrsanumber
Bun-roghainn0.5
0 – 1
A’ chuibhreann de chlàr-ama a’ ghineadh a gheibh stiùireadh: le bhith a’ taghadh 0.5, tha e air a chuingealachadh ri ceumannan bho 0.25 * infer_steps tro 0.75 * infer_steps, a’ fàgail an toiseach agus an deireadh gun stiùireadh.
guidance_interval_decayroghainneil
Seòrsanumber
Bun-roghainn0
0 – 1
Lùghdachadh stiùiridh taobh a-staigh na h-ùine gineadh: cumaidh 0.0 lùghdachadh à comas; air dhòigh eile, lùghdaichidh an sgèile thar na h-ùine sin bho guidance_scale gu min_guidance_scale.
guidance_scaleroghainneil
Seòrsanumber
Bun-roghainn15
0 – 200
Sgèile an stiùiridh a thèid a chur an sàs rè gineadh.
minimum_guidance_scaleroghainneil
Seòrsanumber
Bun-roghainn3
0 – 200
An sgèile stiùiridh as ìsle a ruigear às dèidh lùghdachadh rè gineadh.
tag_guidance_scaleroghainneil
Seòrsanumber
Bun-roghainn5
0 – 10
Sgèile stiùiridh nan tagaichean a thèid a chur an sàs rè gineadh.
lyric_guidance_scaleroghainneil
Seòrsanumber
Bun-roghainn1.5
0 – 10
Sgèile stiùiridh nan l lyrics a thèid a chur an sàs rè gineadh.
riatanach

Toradh

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "ace-step",
  "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": 12,
    "usd": "0.012",
    "charged": 12,
    "refunded": 0
  },
  "input": {
    "tags": "lofi, hiphop, drum and bass, trap, chill"
  },
  "output": {
    "audio": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp3",
      "content_type": "audio/mpeg",
      "file_name": "0-output.mp3",
      "file_size": 1843200
    },
    "seed": 42,
    "tags": "lofi, hiphop, drum and bass, trap, chill",
    "lyrics": "[inst]"
  },
  "outputs": [
    {
      "type": "audio",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp3",
      "content_type": "audio/mpeg",
      "file_size": 1843200,
      "duration": 12,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Na faidhlichean agad, do roghainnTha gach outputs[].url na lethbhreac air an stòradh againn: air a chumail gu bràth (air a phàigheadh gach GB-mìos) no 7 latha an-asgaidh, a rèir suidheachadh a’ chunntais agad no ?storage=.
An aon chruth air gach modailtype, url, content_type, width, height agus duration, airson dealbhan, bhidio agus fuaim le chèile. ’S e output nì toraidh a’ mhodail fhèin.
Raointean toraidh
audio
object {url, content_type, file_name, file_size}Faidhle claisneachd a chaidh a chruthachadh le gineadh.
seed
integerSìol air thuaiream a chaidh a chleachdadh rè gineadh.
tags
stringTagaichean gnè a chaidh an cur an sàs rè gineadh.
lyrics
stringLìrics a chaidh an cur an sàs rè gineadh.

Barrachd mhodalan: Teacsa gu Ceòl

Do riochdairean AI: tha an duilleag seo mar Markdown aig https://doitong.com/gd/developers/models/ace-step.md. Na modailean agus na treòraichean uile: https://doitong.com/developers/llms.txt