Suno Metinden Müziğe

01

Genel Bakış

Metinden müziğe uç noktasını desteklenen bir modelle kullanın. Durumunu almak için döndürülen Görev Kimliğini kullanın veya aşağıda belgelenen teslimler için callback_url sağlayın.

Hızlı başlangıç

Bir API anahtarı oluşturun ve RUNAPI_API_KEY olarak ayarlayın.
Desteklenen bir model seçin ve gövdesi o modelin şemasıyla eşleşen bir POST isteği gönderin.
Döndürülen görev kimliğini saklayın, ardından bir terminal durumuna ulaşana kadar yoklama yapın ya da aşağıda belgelenen geri çağırmaları işleyin.

POST /api/v1/suno/text_to_music

Temel URL: https://runapi.ai
API sürümü: v1
Kimlik doğrulama: Authorization: Bearer YOUR_API_TOKEN

02

Desteklenen modeller

Güncel fiyatlandırma, hız sınırları ve ticari kullanım ayrıntıları için bir model sayfası açın.

03

İstek şeması

JSON gövdesi

Alanlar ve izin verilen değerler seçili modele göre değişir. Sağlandığında, callback_url aşağıda belgelenen Görev teslimatlarını alır.

suno-v415 alan

audio_weightnumber

İsteğe bağlı

Ses ağırlığı (0-1).

Aralık: 0 - 1

callback_urlstring

İsteğe bağlı

Asenkron bildirimler için webhook URL'si.

continue_atnumber

İsteğe bağlı

Devam edilecek saniye cinsinden zaman damgası.

lyricsstring

İsteğe bağlı

Söylenecek tam şarkı sözleri.

Sınır: 5000

modelstring

Zorunlu

Model tanımlayıcısı.

negative_tagsstring

İsteğe bağlı

Kaçınılacak stiller.

persona_idstring

İsteğe bağlı

Persona kimliği.

persona_typestring

İsteğe bağlı

Persona türü.

İzin verilen değerler: style, voice

promptstring

İsteğe bağlı

Otomatik sözler için şarkı özeti.

Sınır: 5000

stylestring

İsteğe bağlı

Müzik tarzı.

Sınır: 1000

style_weightnumber

İsteğe bağlı

Stil uyum ağırlığı (0-1).

Aralık: 0 - 1

titlestring

İsteğe bağlı

Müzik başlığı.

Sınır: 80

vocal_genderstring

İsteğe bağlı

Vokal cinsiyeti.

İzin verilen değerler: male, female

vocal_modestring

Zorunlu

Vokal oluşturma modu.

İzin verilen değerler: auto_lyrics, exact_lyrics, instrumental

weirdness_constraintnumber

İsteğe bağlı

Tuhaflık kısıtlaması (0-1).

Aralık: 0 - 1

suno-v4.515 alan

audio_weightnumber

İsteğe bağlı

Ses ağırlığı (0-1).

Aralık: 0 - 1

callback_urlstring

İsteğe bağlı

Asenkron bildirimler için webhook URL'si.

continue_atnumber

İsteğe bağlı

Devam edilecek saniye cinsinden zaman damgası.

lyricsstring

İsteğe bağlı

Söylenecek tam şarkı sözleri.

Sınır: 5000

modelstring

Zorunlu

Model tanımlayıcısı.

negative_tagsstring

İsteğe bağlı

Kaçınılacak stiller.

persona_idstring

İsteğe bağlı

Persona kimliği.

persona_typestring

İsteğe bağlı

Persona türü.

İzin verilen değerler: style, voice

promptstring

İsteğe bağlı

Otomatik sözler için şarkı özeti.

Sınır: 5000

stylestring

İsteğe bağlı

Müzik tarzı.

Sınır: 1000

style_weightnumber

İsteğe bağlı

Stil uyum ağırlığı (0-1).

Aralık: 0 - 1

titlestring

İsteğe bağlı

Müzik başlığı.

Sınır: 80

vocal_genderstring

İsteğe bağlı

Vokal cinsiyeti.

İzin verilen değerler: male, female

vocal_modestring

Zorunlu

Vokal oluşturma modu.

İzin verilen değerler: auto_lyrics, exact_lyrics, instrumental

weirdness_constraintnumber

İsteğe bağlı

Tuhaflık kısıtlaması (0-1).

Aralık: 0 - 1

suno-v4.5-all15 alan

audio_weightnumber

İsteğe bağlı

Ses ağırlığı (0-1).

Aralık: 0 - 1

callback_urlstring

İsteğe bağlı

Asenkron bildirimler için webhook URL'si.

continue_atnumber

İsteğe bağlı

Devam edilecek saniye cinsinden zaman damgası.

lyricsstring

İsteğe bağlı

Söylenecek tam şarkı sözleri.

Sınır: 5000

modelstring

Zorunlu

Model tanımlayıcısı.

negative_tagsstring

İsteğe bağlı

Kaçınılacak stiller.

persona_idstring

İsteğe bağlı

Persona kimliği.

persona_typestring

İsteğe bağlı

Persona türü.

İzin verilen değerler: style, voice

promptstring

İsteğe bağlı

Otomatik sözler için şarkı özeti.

Sınır: 5000

stylestring

İsteğe bağlı

Müzik tarzı.

Sınır: 1000

style_weightnumber

İsteğe bağlı

Stil uyum ağırlığı (0-1).

Aralık: 0 - 1

titlestring

İsteğe bağlı

Müzik başlığı.

Sınır: 80

vocal_genderstring

İsteğe bağlı

Vokal cinsiyeti.

İzin verilen değerler: male, female

vocal_modestring

Zorunlu

Vokal oluşturma modu.

İzin verilen değerler: auto_lyrics, exact_lyrics, instrumental

weirdness_constraintnumber

İsteğe bağlı

Tuhaflık kısıtlaması (0-1).

Aralık: 0 - 1

suno-v4.5-plus15 alan

audio_weightnumber

İsteğe bağlı

Ses ağırlığı (0-1).

Aralık: 0 - 1

callback_urlstring

İsteğe bağlı

Asenkron bildirimler için webhook URL'si.

continue_atnumber

İsteğe bağlı

Devam edilecek saniye cinsinden zaman damgası.

lyricsstring

İsteğe bağlı

Söylenecek tam şarkı sözleri.

Sınır: 5000

modelstring

Zorunlu

Model tanımlayıcısı.

negative_tagsstring

İsteğe bağlı

Kaçınılacak stiller.

persona_idstring

İsteğe bağlı

Persona kimliği.

persona_typestring

İsteğe bağlı

Persona türü.

İzin verilen değerler: style, voice

promptstring

İsteğe bağlı

Otomatik sözler için şarkı özeti.

Sınır: 5000

stylestring

İsteğe bağlı

Müzik tarzı.

Sınır: 1000

style_weightnumber

İsteğe bağlı

Stil uyum ağırlığı (0-1).

Aralık: 0 - 1

titlestring

İsteğe bağlı

Müzik başlığı.

Sınır: 80

vocal_genderstring

İsteğe bağlı

Vokal cinsiyeti.

İzin verilen değerler: male, female

vocal_modestring

Zorunlu

Vokal oluşturma modu.

İzin verilen değerler: auto_lyrics, exact_lyrics, instrumental

weirdness_constraintnumber

İsteğe bağlı

Tuhaflık kısıtlaması (0-1).

Aralık: 0 - 1

suno-v515 alan

audio_weightnumber

İsteğe bağlı

Ses ağırlığı (0-1).

Aralık: 0 - 1

callback_urlstring

İsteğe bağlı

Asenkron bildirimler için webhook URL'si.

continue_atnumber

İsteğe bağlı

Devam edilecek saniye cinsinden zaman damgası.

lyricsstring

İsteğe bağlı

Söylenecek tam şarkı sözleri.

Sınır: 5000

modelstring

Zorunlu

Model tanımlayıcısı.

negative_tagsstring

İsteğe bağlı

Kaçınılacak stiller.

persona_idstring

İsteğe bağlı

Persona kimliği.

persona_typestring

İsteğe bağlı

Persona türü.

İzin verilen değerler: style, voice

promptstring

İsteğe bağlı

Otomatik sözler için şarkı özeti.

Sınır: 5000

stylestring

İsteğe bağlı

Müzik tarzı.

Sınır: 1000

style_weightnumber

İsteğe bağlı

Stil uyum ağırlığı (0-1).

Aralık: 0 - 1

titlestring

İsteğe bağlı

Müzik başlığı.

Sınır: 80

vocal_genderstring

İsteğe bağlı

Vokal cinsiyeti.

İzin verilen değerler: male, female

vocal_modestring

Zorunlu

Vokal oluşturma modu.

İzin verilen değerler: auto_lyrics, exact_lyrics, instrumental

weirdness_constraintnumber

İsteğe bağlı

Tuhaflık kısıtlaması (0-1).

Aralık: 0 - 1

suno-v5.516 alan

audio_weightnumber

İsteğe bağlı

Ses ağırlığı (0-1).

Aralık: 0 - 1

callback_urlstring

İsteğe bağlı

Asenkron bildirimler için webhook URL'si.

continue_atnumber

İsteğe bağlı

Devam edilecek saniye cinsinden zaman damgası.

duration_secondsinteger

İsteğe bağlı

Saniye cinsinden tercih edilen süre; yalnızca Suno V5.5 özel istekleri için geçerlidir.

Aralık: 10 - 360

lyricsstring

İsteğe bağlı

Söylenecek tam şarkı sözleri.

Sınır: 5000

modelstring

Zorunlu

Model tanımlayıcısı.

negative_tagsstring

İsteğe bağlı

Kaçınılacak stiller.

persona_idstring

İsteğe bağlı

Persona kimliği.

persona_typestring

İsteğe bağlı

Persona türü.

İzin verilen değerler: style, voice

promptstring

İsteğe bağlı

Otomatik sözler için şarkı özeti.

Sınır: 5000

stylestring

İsteğe bağlı

Müzik tarzı.

Sınır: 1000

style_weightnumber

İsteğe bağlı

Stil uyum ağırlığı (0-1).

Aralık: 0 - 1

titlestring

İsteğe bağlı

Müzik başlığı.

Sınır: 80

vocal_genderstring

İsteğe bağlı

Vokal cinsiyeti.

İzin verilen değerler: male, female

vocal_modestring

Zorunlu

Vokal oluşturma modu.

İzin verilen değerler: auto_lyrics, exact_lyrics, instrumental

weirdness_constraintnumber

İsteğe bağlı

Tuhaflık kısıtlaması (0-1).

Aralık: 0 - 1

Koşullu kurallar

Bu gereksinimler, listelenen tüm koşulların eşleştiği durumlarda uygulanır.

Şu durumlarda vocal_mode = auto_lyrics

Gerekli

prompt

Kabul edilmez

lyrics, style, title, negative_tags, vocal_gender, duration_seconds
Şu durumlarda vocal_mode = exact_lyrics

Gerekli

lyrics, style, title

Kabul edilmez

prompt
Şu durumlarda vocal_mode = instrumental

Gerekli

style, title

Kabul edilmez

prompt, lyrics, vocal_gender
Şu durumlarda model = suno-v4

Gerekli

Kabul edilmez

duration_seconds
Şu durumlarda model = suno-v4.5

Gerekli

Kabul edilmez

duration_seconds
Şu durumlarda model = suno-v4.5-all

Gerekli

Kabul edilmez

duration_seconds
Şu durumlarda model = suno-v4.5-plus

Gerekli

Kabul edilmez

duration_seconds
Şu durumlarda model = suno-v5

Gerekli

Kabul edilmez

duration_seconds

04

Kabul oluştur

HTTP 202

POST /api/v1/suno/text_to_music

Yanıt şeması

JSON

{
  "properties": {
    "billing": {
      "properties": {
        "refund": {
          "oneOf": [
            {
              "properties": {
                "refunded_at": {
                  "type": "string"
                }
              },
              "required": [
                "refunded_at"
              ],
              "type": "object",
              "unevaluatedProperties": false
            },
            {
              "enum": [
                null
              ]
            }
          ]
        },
        "reservation": {
          "oneOf": [
            {
              "properties": {
                "amount_cents": {
                  "type": "integer"
                }
              },
              "required": [
                "amount_cents"
              ],
              "type": "object",
              "unevaluatedProperties": false
            },
            {
              "enum": [
                null
              ]
            }
          ]
        },
        "settlement": {
          "oneOf": [
            {
              "properties": {
                "amount_micro_cents": {
                  "type": "integer"
                },
                "charged_amount_cents": {
                  "type": "integer"
                }
              },
              "required": [
                "charged_amount_cents",
                "amount_micro_cents"
              ],
              "type": "object",
              "unevaluatedProperties": false
            },
            {
              "enum": [
                null
              ]
            }
          ]
        }
      },
      "required": [
        "reservation",
        "settlement",
        "refund"
      ],
      "type": "object",
      "unevaluatedProperties": false
    },
    "id": {
      "type": "string"
    },
    "status": {
      "enum": [
        "processing"
      ],
      "type": "string"
    },
    "task_replayed": {
      "type": "boolean"
    }
  },
  "required": [
    "id",
    "status",
    "billing"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Yanıt örneği

JSON

{
  "billing": {
    "refund": null,
    "reservation": null,
    "settlement": null
  },
  "id": "tsk_reference_demo",
  "status": "processing"
}

05

Yoklama işleniyor

HTTP 200

GET /api/v1/suno/text_to_music/:id

Yanıt şeması

JSON

{
  "properties": {
    "audios": {
      "items": {
        "properties": {
          "audio_url": {
            "type": "string",
            "x-runapi-generated-media": true
          },
          "duration": {
            "type": "number"
          },
          "id": {
            "type": "string"
          },
          "image_url": {
            "type": "string",
            "x-runapi-generated-media": true
          },
          "lyrics": {
            "type": "string"
          },
          "model_name": {
            "type": "string"
          },
          "stream_audio_url": {
            "type": "string",
            "x-runapi-generated-media": true
          },
          "tags": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "title": {
            "type": "string"
          }
        },
        "required": [
          "id"
        ],
        "type": "object",
        "unevaluatedProperties": false
      },
      "type": "array"
    },
    "billing": {
      "properties": {
        "refund": {
          "oneOf": [
            {
              "properties": {
                "refunded_at": {
                  "type": "string"
                }
              },
              "required": [
                "refunded_at"
              ],
              "type": "object",
              "unevaluatedProperties": false
            },
            {
              "enum": [
                null
              ]
            }
          ]
        },
        "reservation": {
          "oneOf": [
            {
              "properties": {
                "amount_cents": {
                  "type": "integer"
                }
              },
              "required": [
                "amount_cents"
              ],
              "type": "object",
              "unevaluatedProperties": false
            },
            {
              "enum": [
                null
              ]
            }
          ]
        },
        "settlement": {
          "oneOf": [
            {
              "properties": {
                "amount_micro_cents": {
                  "type": "integer"
                },
                "charged_amount_cents": {
                  "type": "integer"
                }
              },
              "required": [
                "charged_amount_cents",
                "amount_micro_cents"
              ],
              "type": "object",
              "unevaluatedProperties": false
            },
            {
              "enum": [
                null
              ]
            }
          ]
        }
      },
      "required": [
        "reservation",
        "settlement",
        "refund"
      ],
      "type": "object",
      "unevaluatedProperties": false
    },
    "generation_stage": {
      "enum": [
        "text_generated",
        "first_audio_ready"
      ],
      "type": "string"
    },
    "id": {
      "type": "string"
    },
    "status": {
      "enum": [
        "processing"
      ],
      "type": "string"
    }
  },
  "required": [
    "id",
    "status",
    "billing"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Yanıt örneği

JSON

{
  "billing": {
    "refund": null,
    "reservation": null,
    "settlement": null
  },
  "generation_stage": "text_generated",
  "id": "tsk_reference_demo",
  "status": "processing"
}

06

Yoklama tamamlandı

HTTP 200

GET /api/v1/suno/text_to_music/:id

Yanıt şeması

JSON

{
  "properties": {
    "audios": {
      "items": {
        "properties": {
          "audio_url": {
            "type": "string",
            "x-runapi-generated-media": true
          },
          "duration": {
            "type": "number"
          },
          "id": {
            "type": "string"
          },
          "image_url": {
            "type": "string",
            "x-runapi-generated-media": true
          },
          "lyrics": {
            "type": "string"
          },
          "model_name": {
            "type": "string"
          },
          "stream_audio_url": {
            "type": "string",
            "x-runapi-generated-media": true
          },
          "tags": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "title": {
            "type": "string"
          }
        },
        "required": [
          "id"
        ],
        "type": "object",
        "unevaluatedProperties": false
      },
      "type": "array"
    },
    "billing": {
      "properties": {
        "refund": {
          "oneOf": [
            {
              "properties": {
                "refunded_at": {
                  "type": "string"
                }
              },
              "required": [
                "refunded_at"
              ],
              "type": "object",
              "unevaluatedProperties": false
            },
            {
              "enum": [
                null
              ]
            }
          ]
        },
        "reservation": {
          "oneOf": [
            {
              "properties": {
                "amount_cents": {
                  "type": "integer"
                }
              },
              "required": [
                "amount_cents"
              ],
              "type": "object",
              "unevaluatedProperties": false
            },
            {
              "enum": [
                null
              ]
            }
          ]
        },
        "settlement": {
          "oneOf": [
            {
              "properties": {
                "amount_micro_cents": {
                  "type": "integer"
                },
                "charged_amount_cents": {
                  "type": "integer"
                }
              },
              "required": [
                "charged_amount_cents",
                "amount_micro_cents"
              ],
              "type": "object",
              "unevaluatedProperties": false
            },
            {
              "enum": [
                null
              ]
            }
          ]
        }
      },
      "required": [
        "reservation",
        "settlement",
        "refund"
      ],
      "type": "object",
      "unevaluatedProperties": false
    },
    "generation_stage": {
      "enum": [
        "text_generated",
        "first_audio_ready",
        "all_audios_ready",
        "failed"
      ],
      "type": "string"
    },
    "id": {
      "type": "string"
    },
    "status": {
      "enum": [
        "completed"
      ],
      "type": "string"
    }
  },
  "required": [
    "id",
    "status",
    "audios",
    "billing"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Yanıt örneği

JSON

{
  "audios": [
    {
      "audio_url": "https://file.runapi.ai/reference-audio.mp3",
      "id": "audio_reference"
    }
  ],
  "billing": {
    "refund": null,
    "reservation": null,
    "settlement": null
  },
  "id": "tsk_reference_demo",
  "status": "completed"
}

07

Yoklama başarısız oldu

HTTP 200

GET /api/v1/suno/text_to_music/:id

Yanıt şeması

JSON

{
  "properties": {
    "billing": {
      "properties": {
        "refund": {
          "oneOf": [
            {
              "properties": {
                "refunded_at": {
                  "type": "string"
                }
              },
              "required": [
                "refunded_at"
              ],
              "type": "object",
              "unevaluatedProperties": false
            },
            {
              "enum": [
                null
              ]
            }
          ]
        },
        "reservation": {
          "oneOf": [
            {
              "properties": {
                "amount_cents": {
                  "type": "integer"
                }
              },
              "required": [
                "amount_cents"
              ],
              "type": "object",
              "unevaluatedProperties": false
            },
            {
              "enum": [
                null
              ]
            }
          ]
        },
        "settlement": {
          "oneOf": [
            {
              "properties": {
                "amount_micro_cents": {
                  "type": "integer"
                },
                "charged_amount_cents": {
                  "type": "integer"
                }
              },
              "required": [
                "charged_amount_cents",
                "amount_micro_cents"
              ],
              "type": "object",
              "unevaluatedProperties": false
            },
            {
              "enum": [
                null
              ]
            }
          ]
        }
      },
      "required": [
        "reservation",
        "settlement",
        "refund"
      ],
      "type": "object",
      "unevaluatedProperties": false
    },
    "error": {
      "type": "string"
    },
    "id": {
      "type": "string"
    },
    "status": {
      "enum": [
        "failed"
      ],
      "type": "string"
    }
  },
  "required": [
    "id",
    "status",
    "error",
    "billing"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Yanıt örneği

JSON

{
  "billing": {
    "refund": null,
    "reservation": null,
    "settlement": null
  },
  "error": "Task processing failed.",
  "id": "tsk_reference_demo",
  "status": "failed"
}

08

Müşteri geri çağırması: işleniyor

HTTP 200

POST callback_url

Yanıt şeması

JSON

{
  "properties": {
    "audios": {
      "items": {
        "properties": {
          "audio_url": {
            "type": "string",
            "x-runapi-generated-media": true
          },
          "duration": {
            "type": "number"
          },
          "id": {
            "type": "string"
          },
          "image_url": {
            "type": "string",
            "x-runapi-generated-media": true
          },
          "lyrics": {
            "type": "string"
          },
          "model_name": {
            "type": "string"
          },
          "stream_audio_url": {
            "type": "string",
            "x-runapi-generated-media": true
          },
          "tags": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "title": {
            "type": "string"
          }
        },
        "required": [
          "id"
        ],
        "type": "object",
        "unevaluatedProperties": false
      },
      "type": "array"
    },
    "generation_stage": {
      "enum": [
        "text_generated",
        "first_audio_ready"
      ],
      "type": "string"
    },
    "id": {
      "type": "string"
    },
    "status": {
      "enum": [
        "processing"
      ],
      "type": "string"
    }
  },
  "required": [
    "id",
    "status"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Yanıt örneği

JSON

{
  "generation_stage": "text_generated",
  "id": "tsk_reference_demo",
  "status": "processing"
}

09

Müşteri geri çağırması: tamamlandı

HTTP 200

POST callback_url

Yanıt şeması

JSON

{
  "properties": {
    "audios": {
      "items": {
        "properties": {
          "audio_url": {
            "type": "string",
            "x-runapi-generated-media": true
          },
          "duration": {
            "type": "number"
          },
          "id": {
            "type": "string"
          },
          "image_url": {
            "type": "string",
            "x-runapi-generated-media": true
          },
          "lyrics": {
            "type": "string"
          },
          "model_name": {
            "type": "string"
          },
          "stream_audio_url": {
            "type": "string",
            "x-runapi-generated-media": true
          },
          "tags": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "title": {
            "type": "string"
          }
        },
        "required": [
          "id"
        ],
        "type": "object",
        "unevaluatedProperties": false
      },
      "type": "array"
    },
    "generation_stage": {
      "enum": [
        "text_generated",
        "first_audio_ready",
        "all_audios_ready",
        "failed"
      ],
      "type": "string"
    },
    "id": {
      "type": "string"
    },
    "status": {
      "enum": [
        "completed"
      ],
      "type": "string"
    }
  },
  "required": [
    "id",
    "status",
    "audios"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Yanıt örneği

JSON

{
  "audios": [
    {
      "audio_url": "https://file.runapi.ai/reference-audio.mp3",
      "id": "audio_reference"
    }
  ],
  "id": "tsk_reference_demo",
  "status": "completed"
}

10

Müşteri geri çağırması: başarısız oldu

HTTP 200

POST callback_url

Yanıt şeması

JSON

{
  "properties": {
    "error": {
      "oneOf": [
        {
          "type": "string"
        },
        {
          "properties": {
            "code": {
              "type": "string"
            },
            "limit_cents": {
              "type": "integer"
            },
            "message": {
              "type": "string"
            },
            "reset_at": {
              "format": "date-time",
              "type": [
                "string",
                "null"
              ]
            },
            "used_cents": {
              "type": "integer"
            },
            "window": {
              "enum": [
                "1h",
                "1d",
                "7d",
                "daily",
                "weekly",
                "monthly",
                "lifetime"
              ],
              "type": "string"
            }
          },
          "required": [
            "code",
            "message"
          ],
          "type": "object",
          "unevaluatedProperties": false
        }
      ]
    },
    "id": {
      "type": "string"
    },
    "status": {
      "enum": [
        "failed"
      ],
      "type": "string"
    }
  },
  "required": [
    "id",
    "status",
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Yanıt örneği

JSON

{
  "error": {
    "code": "generation_failed",
    "message": "Task processing failed."
  },
  "id": "tsk_reference_demo",
  "status": "failed"
}

11

Hatalar

HTTP 401

POST /api/v1/suno/text_to_music

Yanıt şeması

JSON

{
  "properties": {
    "error": {
      "description": "İnsan tarafından okunabilir hata mesajı.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Yanıt örneği

JSON

{
  "error": "Authentication required"
}

12

Hatalar

HTTP 401

GET /api/v1/suno/text_to_music/:id

Yanıt şeması

JSON

{
  "properties": {
    "error": {
      "description": "İnsan tarafından okunabilir hata mesajı.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Yanıt örneği

JSON

{
  "error": "Authentication required"
}

13

Hatalar

HTTP 400

POST /api/v1/suno/text_to_music

Yanıt şeması

JSON

{
  "oneOf": [
    {
      "properties": {
        "error": {
          "description": "İnsan tarafından okunabilir hata mesajı.",
          "type": "string"
        }
      },
      "required": [
        "error"
      ],
      "type": "object",
      "unevaluatedProperties": false
    },
    {
      "properties": {
        "error": {
          "description": "İnsan tarafından okunabilir doğrulama özeti.",
          "type": "string"
        },
        "errors": {
          "additionalProperties": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "description": "Herkese açık istek alanına göre anahtarlanan doğrulama mesajları; her alan için insan tarafından okunabilir dizelerden oluşan bir dizi içerir.",
          "type": "object"
        }
      },
      "required": [
        "error",
        "errors"
      ],
      "type": "object",
      "unevaluatedProperties": false
    }
  ]
}

Yanıt örneği

JSON

{
  "error": "Validation failed",
  "errors": {
    "prompt": [
      "is required"
    ]
  }
}

14

Hatalar

HTTP 402

POST /api/v1/suno/text_to_music

Yanıt şeması

JSON

{
  "properties": {
    "error": {
      "description": "İnsan tarafından okunabilir hata mesajı.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Yanıt örneği

JSON

{
  "error": "Insufficient balance"
}

15

Hatalar

HTTP 429

POST /api/v1/suno/text_to_music

Yanıt şeması

JSON

{
  "properties": {
    "error": {
      "description": "İnsan tarafından okunabilir hata mesajı.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Yanıt örneği

JSON

{
  "error": "API key credit limit exceeded"
}

16

Hatalar

HTTP 409

POST /api/v1/suno/text_to_music

Yanıt şeması

JSON

{
  "properties": {
    "error": {
      "description": "İnsan tarafından okunabilir hata mesajı.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Yanıt örneği

JSON

{
  "error": "The request uses features that are not supported for the selected model"
}

17

Hatalar

HTTP 429

POST /api/v1/suno/text_to_music

Yanıt şeması

JSON

{
  "properties": {
    "error": {
      "description": "İnsan tarafından okunabilir hata mesajı.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Yanıt örneği

JSON

{
  "error": "Rate limit reached. Please retry later."
}

18

Hatalar

HTTP 503

POST /api/v1/suno/text_to_music

Yanıt şeması

JSON

{
  "properties": {
    "error": {
      "description": "İnsan tarafından okunabilir hata mesajı.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Yanıt örneği

JSON

{
  "error": "Service under maintenance, please try again later"
}

19

Hatalar

HTTP 504

POST /api/v1/suno/text_to_music

Yanıt şeması

JSON

{
  "properties": {
    "error": {
      "description": "İnsan tarafından okunabilir hata mesajı.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Yanıt örneği

JSON

{
  "error": "The request timed out"
}

20

Hatalar

HTTP 404

GET /api/v1/suno/text_to_music/:id

Yanıt şeması

JSON

{
  "properties": {
    "error": {
      "description": "İnsan tarafından okunabilir hata mesajı.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Yanıt örneği

JSON

{
  "error": "Task with id 'tsk_reference_demo' not found"
}

21

Oluşturulan Kod Örnekleri

Doğrudan cURL kullanın veya diliniz için bir SDK yükleyin. Her örnek, bu başvuruda gösterilen doğrulanmış isteği gönderir.

Yükle

Shell

pip install runapi-suno

PYTHON

import os
from runapi.suno import SunoClient

client = SunoClient(api_key=os.environ["RUNAPI_API_KEY"])
task = client.text_to_music.create(
  model="suno-v5",
  vocal_mode="auto_lyrics",
  prompt="An uplifting acoustic pop song about a rainy city night.",
  persona_id="persona_reference",
  persona_type="style"
)

Yükle

Shell

npm install @runapi.ai/suno

JAVASCRIPT

import { SunoClient } from "@runapi.ai/suno";

const client = new SunoClient({ apiKey: process.env.RUNAPI_API_KEY });
const task = await client.textToMusic.create({
  "model": "suno-v5",
  "vocal_mode": "auto_lyrics",
  "prompt": "An uplifting acoustic pop song about a rainy city night.",
  "persona_id": "persona_reference",
  "persona_type": "style"
});

CURL

curl -X POST https://runapi.ai/api/v1/suno/text_to_music \
  -H 'Authorization: Bearer YOUR_API_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"model":"suno-v5","vocal_mode":"auto_lyrics","prompt":"An uplifting acoustic pop song about a rainy city night.","persona_id":"persona_reference","persona_type":"style"}'

Yükle

Shell

go get github.com/runapi-ai/suno-sdk/go@latest

GO

package main

import (
  "context"
  "log"
  "os"

  "github.com/runapi-ai/core-sdk/go/option"
  suno "github.com/runapi-ai/suno-sdk/go/suno"
)

func main() {
  client, err := suno.NewClient(option.WithAPIKey(os.Getenv("RUNAPI_API_KEY")))
  if err != nil {
    log.Fatal(err)
  }

  task, err := client.TextToMusic.Create(context.Background(), suno.TextToMusicParams{
    VocalMode: suno.VocalMode("auto_lyrics"),
    Prompt: "An uplifting acoustic pop song about a rainy city night.",
    PersonaID: "persona_reference",
    PersonaType: suno.PersonaType("style"),
    SunoBaseParams: suno.SunoBaseParams{Model: suno.SunoModel("suno-v5")},
  })
  if err != nil {
    log.Fatal(err)
  }
  _ = task
}

22

Suno Metinden Müziğe

Genel Bakış

Hızlı başlangıç

Uç Nokta

Desteklenen modeller

İstek şeması

Koşullu kurallar

Kabul oluştur

Yanıt örneği

Yoklama işleniyor

Yanıt örneği

Yoklama tamamlandı

Yanıt örneği

Yoklama başarısız oldu

Yanıt örneği

Müşteri geri çağırması: işleniyor

Yanıt örneği

Müşteri geri çağırması: tamamlandı

Yanıt örneği

Müşteri geri çağırması: başarısız oldu

Yanıt örneği

Hatalar

Yanıt örneği

Hatalar

Yanıt örneği

Hatalar

Yanıt örneği

Hatalar

Yanıt örneği

Hatalar

Yanıt örneği

Hatalar

Yanıt örneği

Hatalar

Yanıt örneği

Hatalar

Yanıt örneği

Hatalar

Yanıt örneği

Hatalar

Yanıt örneği

Oluşturulan Kod Örnekleri

Yükle

İlgili Kılavuzlar