مواد پر جائیں

ACE Step

انٹیگریٹ کریں

ماڈل id 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"

یہ درخواست: ⁨$0.012⁩ 12 API کریڈٹس اس صفحے پر چلائیں

API کلید حاصل کریں
ACE Studio متن سے موسیقی 5–240 s #text-to-audio#text-to-music

صنف کے ٹیگز اور اختیاری بول سے 5 سے 240 سیکنڈ کی موسیقی ترتیب دیتا ہے

ACE Studio · آڈیو

آپ کا پہلا نتیجہ یہاں آئے گا

ذیل میں درخواست بنائیں اور اپنی API کلید کے ساتھ چلائیں۔ آؤٹ پٹس ہمارے اسٹوریج میں کاپی ہو جاتے ہیں، ہمیشہ کے لیے یا مفت میں 7 دن تک محفوظ رہتے ہیں۔

درخواست بنائیں

کنٹرولز ماڈل اسکیما سے تیار ہوتے ہیں۔ آپ کے بدلنے کے ساتھ کوڈ اور قیمت اپ ڈیٹ ہوتے ہیں۔

•لازمی

آڈیو اسٹائل ٹیگز، جو کوما سے الگ کردہ اصناف کی صورت میں دیے جاتے ہیں؛ انہیں فراہم کرنے کے متبادل طریقے کے طور پر `prompt` بھی دستیاب ہے۔

ڈیفالٹ 60

تخلیق کردہ آڈیو کی لمبائی، سیکنڈ میں۔

ایڈوانسڈ 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
ڈیفالٹ

گائے گئے بول، جن میں گانے کے حصے [verse]، [chorus] اور [bridge] جیسے کنٹرولز کے ذریعے منظم کیے گئے ہوں۔ بغیر گائے گئے بول کے آڈیو کے لیے اس ان پٹ کو چھوڑ دیں یا صرف [inst] یا [instrumental] فراہم کریں۔

scheduler ڈیفالٹ euler

تخلیق کے دوران استعمال ہونے والا شیڈیولر۔

guidance_type ڈیفالٹ apg

تخلیق کے دوران استعمال ہونے والی CFG قسم۔

ڈیفالٹ 27

آڈیو تخلیق کے دوران استعمال ہونے والی اسٹیپس کی تعداد۔

ڈیفالٹ 10

تخلیق کے دوران لاگو ہونے والا گرانولیئرٹی اسکیل۔ اسے بڑھانے سے آرٹیفیکٹس کم ہو سکتے ہیں۔

ڈیفالٹ 0.5

تخلیق کے شیڈیول کا وہ حصہ جسے گائیڈنس ملتی ہے: 0.5 منتخب کرنے سے یہ `0.25 * infer_steps` سے `0.75 * infer_steps` تک کی اسٹیپس تک محدود ہو جاتا ہے، جبکہ آغاز اور اختتام بغیر گائیڈنس کے رہتے ہیں۔

ڈیفالٹ 0

تخلیق کے وقفے کے اندر گائیڈنس ڈِیکی: 0.0 ڈِیکی کو غیر فعال رکھتا ہے؛ بصورتِ دیگر اس وقفے کے دوران اسکیل `guidance_scale` سے `min_guidance_scale` تک کم ہوتا ہے۔

ڈیفالٹ 15

تخلیق کے دوران لاگو ہونے والی گائیڈنس کا اسکیل۔

ڈیفالٹ 3

تخلیق کے دوران ڈِیکی کے بعد حاصل ہونے والا کم ترین گائیڈنس اسکیل۔

ڈیفالٹ 5

تخلیق کے دوران لاگو ہونے والی ٹیگ گائیڈنس کا اسکیل۔

ڈیفالٹ 1.5

تخلیق کے دوران لاگو ہونے والی بولوں کی گائیڈنس کا اسکیل۔

قابلِ تکرار تخلیق کے لیے سیڈ؛ قدر فراہم نہ کرنے پر تصادفی طور پر منتخب کیا جاتا ہے۔

POST /run/ace-step?wait=20 قیمت → ⁨$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"

یہ درخواست چلائیں

آپ کی key اسی براؤزر میں رہتی ہے: یہ صرف Doitong API کو بھیجی جاتی ہے اور صرف اس صورت میں localStorage میں محفوظ ہوتی ہے جب آپ Remember منتخب کریں۔ API کلید حاصل کریں

ACE Step کے بارے میں

کاما سے جدا کردہ انداز کے `tags` اور اختیاری `lyrics` سے موسیقی کا ٹریک بناتا ہے۔ [verse] اور [chorus] جیسے سیکشن مارکر گانے کی ساخت بناتے ہیں، جبکہ [inst] سازینہ موسیقی تیار کرتا ہے۔ `duration` 5 سے 240 سیکنڈ تک ہوتا ہے۔ سیمپلنگ کنٹرولز میں `scheduler` (euler یا heun)، `guidance_type` اور 3 سے 60 تک `number_of_steps` شامل ہیں۔

پیرامیٹرز

نامقسم ڈیفالٹمجاز تفصیل
tagsلازمی
قسمstring
آڈیو اسٹائل ٹیگز، جو کوما سے الگ کردہ اصناف کی صورت میں دیے جاتے ہیں؛ انہیں فراہم کرنے کے متبادل طریقے کے طور پر `prompt` بھی دستیاب ہے۔
lyricsاختیاری
قسمstring
ڈیفالٹ
گائے گئے بول، جن میں گانے کے حصے [verse]، [chorus] اور [bridge] جیسے کنٹرولز کے ذریعے منظم کیے گئے ہوں۔ بغیر گائے گئے بول کے آڈیو کے لیے اس ان پٹ کو چھوڑ دیں یا صرف [inst] یا [instrumental] فراہم کریں۔
durationاختیاری
قسمnumber
ڈیفالٹ60
5 – 240
تخلیق کردہ آڈیو کی لمبائی، سیکنڈ میں۔
number_of_stepsاختیاری
قسمinteger
ڈیفالٹ27
3 – 60
آڈیو تخلیق کے دوران استعمال ہونے والی اسٹیپس کی تعداد۔
seedاختیاری
قسمinteger | null
قابلِ تکرار تخلیق کے لیے سیڈ؛ قدر فراہم نہ کرنے پر تصادفی طور پر منتخب کیا جاتا ہے۔
schedulerاختیاری
قسمenum
ڈیفالٹeuler
eulerheun
تخلیق کے دوران استعمال ہونے والا شیڈیولر۔
guidance_typeاختیاری
قسمenum
ڈیفالٹapg
cfgapgcfg_star
تخلیق کے دوران استعمال ہونے والی CFG قسم۔
granularity_scaleاختیاری
قسمinteger
ڈیفالٹ10
-100 – 100
تخلیق کے دوران لاگو ہونے والا گرانولیئرٹی اسکیل۔ اسے بڑھانے سے آرٹیفیکٹس کم ہو سکتے ہیں۔
guidance_intervalاختیاری
قسمnumber
ڈیفالٹ0.5
0 – 1
تخلیق کے شیڈیول کا وہ حصہ جسے گائیڈنس ملتی ہے: 0.5 منتخب کرنے سے یہ `0.25 * infer_steps` سے `0.75 * infer_steps` تک کی اسٹیپس تک محدود ہو جاتا ہے، جبکہ آغاز اور اختتام بغیر گائیڈنس کے رہتے ہیں۔
guidance_interval_decayاختیاری
قسمnumber
ڈیفالٹ0
0 – 1
تخلیق کے وقفے کے اندر گائیڈنس ڈِیکی: 0.0 ڈِیکی کو غیر فعال رکھتا ہے؛ بصورتِ دیگر اس وقفے کے دوران اسکیل `guidance_scale` سے `min_guidance_scale` تک کم ہوتا ہے۔
guidance_scaleاختیاری
قسمnumber
ڈیفالٹ15
0 – 200
تخلیق کے دوران لاگو ہونے والی گائیڈنس کا اسکیل۔
minimum_guidance_scaleاختیاری
قسمnumber
ڈیفالٹ3
0 – 200
تخلیق کے دوران ڈِیکی کے بعد حاصل ہونے والا کم ترین گائیڈنس اسکیل۔
tag_guidance_scaleاختیاری
قسمnumber
ڈیفالٹ5
0 – 10
تخلیق کے دوران لاگو ہونے والی ٹیگ گائیڈنس کا اسکیل۔
lyric_guidance_scaleاختیاری
قسمnumber
ڈیفالٹ1.5
0 – 10
تخلیق کے دوران لاگو ہونے والی بولوں کی گائیڈنس کا اسکیل۔
لازمی

آؤٹ پٹ

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"
  }
}
آپ کی فائلیں، آپ کا انتخابہر outputs[].url ہمارے اسٹوریج میں ایک کاپی ہے: ہمیشہ کے لیے محفوظ (فی GB-ماہ ادائیگی) یا مفت میں 7 دن تک، آپ کی اکاؤنٹ سیٹنگ یا ?storage= کے مطابق۔
ہر ماڈل میں ایک جیسی ساختtype، url، content_type، width، height اور duration، تصاویر، ویڈیو اور آڈیو سب کے لیے یکساں۔ output ماڈل کا اپنا نتیجہ آبجیکٹ ہے۔
آؤٹ پٹ کے فیلڈز
audio
object {url, content_type, file_name, file_size}تخلیق سے تیار کردہ آڈیو فائل۔
seed
integerتخلیق کے دوران استعمال ہونے والا تصادفی سیڈ۔
tags
stringتخلیق کے دوران لاگو کیے گئے نوع کے ٹیگز۔
lyrics
stringتخلیق کے دوران لاگو کیے گئے بول۔

مزید ماڈلز: متن سے موسیقی

AI ایجنٹس کے لیے: یہ صفحہ Markdown میں یہاں موجود ہے https://doitong.com/ur/developers/models/ace-step.md. تمام ماڈلز اور گائیڈز: https://doitong.com/developers/llms.txt