Query: Single Task

Short description: Query detailed status and results for a single Suno music or lyrics generation task.

---

Overview

• Method: GET
• Path: /suno/fetch/{task_id}
• Content-Type: application/json

Authentication

• Header: Authorization: Bearer <token>

---

Request Example

Path Parameters

Parameter	Type	Required	Description
task_id	string	Yes	Task ID, for example 2a145658-3342-4228-b779-b8323a2b77df

---

curl Example

curl -X GET "https://api.gpt.ge/suno/fetch/2a145658-3342-4228-b779-b8323a2b77df" \
  -H "Authorization: Bearer sk-xxxx"

JavaScript (fetch) Example

fetch('https://api.gpt.ge/suno/fetch/2a145658-3342-4228-b779-b8323a2b77df', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer sk-xxxx'
  }
}).then(r => r.json()).then(console.log);

Python (requests) Example

import requests

response = requests.get(
    'https://api.gpt.ge/suno/fetch/2a145658-3342-4228-b779-b8323a2b77df',
    headers={'Authorization': 'Bearer sk-xxxx'}
)
print(response.json())

---

Response Example (200)

{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "2a145658-3342-4228-b779-b8323a2b77df",
    "action": "MUSIC",
    "status": "SUCCESS",
    "fail_reason": "",
    "submit_time": 1726911801,
    "start_time": 1726911812,
    "finish_time": 1726911897,
    "progress": "100%",
    "data": [
      {
        "id": "3435e194-50e7-4edc-9442-bffe072fccfc",
        "title": "Happy Weekend",
        "handle": "yellowrobots6855",
        "status": "complete",
        "user_id": "ee5e241a-ead6-435d-bea8-526c77c04c72",
        "is_liked": false,
        "metadata": {
          "tags": "heartfelt salsa",
          "type": "gen",
          "prompt": "",
          "stream": true,
          "history": null,
          "duration": 128.92,
          "error_type": null,
          "error_message": null,
          "concat_history": null,
          "refund_credits": false,
          "audio_prompt_id": null,
          "gpt_description_prompt": null
        },
        "reaction": null,
        "audio_url": "https://cdn1.suno.ai/3435e194-50e7-4edc-9442-bffe072fccfc.mp3",
        "image_url": "https://cdn2.suno.ai/image_3435e194-50e7-4edc-9442-bffe072fccfc.jpeg",
        "is_public": false,
        "video_url": "https://cdn1.suno.ai/3435e194-50e7-4edc-9442-bffe072fccfc.mp4",
        "created_at": "2024-09-21T09:43:21.637Z",
        "is_trashed": false,
        "model_name": "chirp-v3",
        "play_count": 0,
        "display_name": "YellowRobots6855",
        "upvote_count": 0,
        "image_large_url": "https://cdn2.suno.ai/image_large_3435e194-50e7-4edc-9442-bffe072fccfc.jpeg",
        "is_video_pending": false,
        "is_handle_updated": false,
        "major_model_version": "v3.5"
      }
    ]
  }
}

Note: This endpoint queries a single Suno task and returns task status, progress, result data, and media links.