Konvensi Umum Suno & Kueri Tugas

curl --request GET \
  --url https://api.apimart.ai/v1/music/tasks/{task_id}

import requests

url = "https://api.apimart.ai/v1/music/tasks/{task_id}"

response = requests.get(url)

print(response.text)

const options = {method: 'GET'};

fetch('https://api.apimart.ai/v1/music/tasks/{task_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.apimart.ai/v1/music/tasks/{task_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.apimart.ai/v1/music/tasks/{task_id}"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.apimart.ai/v1/music/tasks/{task_id}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.apimart.ai/v1/music/tasks/{task_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "task_id": "task_01ABC...",
  "status": "completed",
  "progress": 100,
  "data": {
    "result": {
      "music": [
        {
          "audio_id": "<track id, used with audio_index to locate it for subsequent operations>",
          "title": "Summer Breeze",
          "duration": 128.5,
          "lyrics": "……",
          "tags": "electronic, upbeat",
          "audio_url": "https://.../xxx.mp3",
          "image_url": "https://.../cover.png",
          "image_large_url": "https://.../cover_large.png",
          "video_url": "https://.../mv.mp4"
        }
      ]
    }
  }
}

{
  "task_id": "task_01ABC...",
  "status": "failed",
  "progress": 100,
  "data": {
    "error": {
      "message": "generation failed"
    }
  }
}

GET

music

tasks

{task_id}

Konvensi Umum Suno & Kueri Tugas

curl --request GET \
  --url https://api.apimart.ai/v1/music/tasks/{task_id}

import requests

url = "https://api.apimart.ai/v1/music/tasks/{task_id}"

response = requests.get(url)

print(response.text)

const options = {method: 'GET'};

fetch('https://api.apimart.ai/v1/music/tasks/{task_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.apimart.ai/v1/music/tasks/{task_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.apimart.ai/v1/music/tasks/{task_id}"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.apimart.ai/v1/music/tasks/{task_id}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.apimart.ai/v1/music/tasks/{task_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "task_id": "task_01ABC...",
  "status": "completed",
  "progress": 100,
  "data": {
    "result": {
      "music": [
        {
          "audio_id": "<track id, used with audio_index to locate it for subsequent operations>",
          "title": "Summer Breeze",
          "duration": 128.5,
          "lyrics": "……",
          "tags": "electronic, upbeat",
          "audio_url": "https://.../xxx.mp3",
          "image_url": "https://.../cover.png",
          "image_large_url": "https://.../cover_large.png",
          "video_url": "https://.../mv.mp4"
        }
      ]
    }
  }
}

{
  "task_id": "task_01ABC...",
  "status": "failed",
  "progress": 100,
  "data": {
    "error": {
      "message": "generation failed"
    }
  }
}

Halaman ini adalah konvensi umum untuk semua antarmuka musik Suno, digunakan bersama dokumentasi terpisah setiap endpoint. Semua antarmuka pembuatan / pengeditan bersifat tugas asinkron: kirim untuk mendapatkan task_id, lalu polling antarmuka kueri di halaman ini untuk mengambil hasilnya.

Autentikasi

Semua permintaan perlu menyertakan pada header permintaan:

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Kunjungi halaman pengelolaan API Key untuk mendapatkan API Key.

Siklus hidup tugas (semua antarmuka bersifat asinkron)

Kirim

POST /v1/music/generations/<operation> → segera mengembalikan task_id dari pihak kami:

{ "code": 200, "data": [ { "status": "submitted", "task_id": "task_xxx" } ] }

Polling

GET /v1/music/tasks/:task_id hingga status menjadi completed atau failed. Selama proses pembuatan, status bernilai pending, dan progress berjalan: antre 10 → siap 50 → selesai 100. Disarankan interval polling 3–5s; pembuatan musik biasanya 30–120s.

Ambil hasil

Setelah selesai, ambil audio_url / image_url / video_url dan lainnya dari data.result.music[].

Alur status tugas: submitted → pending → completed / failed. Saat gagal, data.error.message memberikan alasannya, dan kuota yang dipotong di muka dikembalikan otomatis.

Versi version

v3.5 / v4 / v4.5 / v4.5+ / v4.5-all / v5 / v5.5, memengaruhi kualitas audio dan penagihan; jika tidak dikirim menggunakan default. Versi yang tersedia dan nilai default berbeda-beda per endpoint — sebagian endpoint hanya mendukung subset, dan sebagian tidak memiliki dimensi versi sama sekali; lihat dokumentasi masing-masing endpoint.

Referensi audio sumber: task_id + audio_index

Operasi berbasis lagu yang sudah ada (perpanjangan / cover / pemisahan trek / penambahan vokal / pemotongan…) tidak perlu mencatat id pihak hulu apa pun, cukup kirim:

task_id: task_id pihak kami dari tugas yang menghasilkan audio sumber
audio_index: lagu ke berapa di dalam music[] hasil tugas tersebut (berbasis 1, default 1; satu kali pembuatan biasanya 2 lagu: 1 dan 2)

Jika sumber tidak dapat diresolusi (tugas belum selesai / indeks di luar batas / task_id tidak ditemukan), 400 dikembalikan pada saat pengiriman.

Kueri tugas: GET /v1/music/tasks/:task_id

task_id

string

wajib

task_id pihak kami yang dikembalikan antarmuka pengiriman.

Polling antarmuka ini hingga status menjadi completed atau failed. Setelah selesai, ambil produk dari data.result.music[].

Response

task_id

string

Pengenal unik tugas

status

string

Status tugas: submitted / pending / completed / failed

progress

integer

Progres: antre 10 → siap 50 → selesai 100

data

object

Data hasil

Tampilkan Properti

result

object

Ada saat status bernilai completed

Tampilkan Properti result

music

array

Daftar produk (satu kali pembuatan biasanya 2 lagu)

Tampilkan Properti music[]

audio_id

string

id audio, digunakan untuk operasi berikutnya guna melokasikan dengan audio_index

title

string

Judul

duration

number

Durasi (detik)

lyrics

string

Lirik

Ikhtisar

Seri Teks

Seri Gambar

Seri Video

Seri Audio

Seri Moderasi

Manajemen Unggahan

Manajemen Tugas

Manajemen Akun

Konvensi Umum Suno & Kueri Tugas

Autentikasi

Siklus hidup tugas (semua antarmuka bersifat asinkron)

Versi version

Referensi audio sumber: task_id + audio_index

Kueri tugas: GET /v1/music/tasks/:task_id

Response

​Autentikasi

​Siklus hidup tugas (semua antarmuka bersifat asinkron)

​Versi version

​Referensi audio sumber: task_id + audio_index

​Kueri tugas: GET /v1/music/tasks/:task_id

​Response

Autentikasi

Siklus hidup tugas (semua antarmuka bersifat asinkron)

Versi version

Referensi audio sumber: task_id + audio_index

Kueri tugas: GET /v1/music/tasks/:task_id

Response