Suno API: промпты и сценарии через один эндпоинт

Аутентификация и базовый URL

Наше API использует стандартную аутентификацию OpenAI. Вам нужен только API-ключ, который вы генерируете на странице Получить API-ключ. Для начала не требуется номер телефона или кредитная карта; каждый новый аккаунт получает $0,50 пробного баланса, действительного в течение 7 дней.

Укажите базовый URL https://api.sunoapis.com/v1 в конфигурации клиента. Идентификатор модели, который необходимо указывать в каждом запросе, — uncensored. Это модель с открытыми весами, размещённая на наших GPU-серверах и адаптированная для законного использования взрослым контентом и в творческих целях без отказов, характерных для крупных провайдеров.

• Базовый URL: https://api.sunoapis.com/v1
• Идентификатор модели: uncensored
• Заголовок авторизации: Authorization: Bearer YOUR_API_KEY

Первый запрос

Начните работу немедленно со стандартного запроса на завершение чата. Эндпоинт принимает JSON-пакеты, содержащие системный промпт, инструкции пользователя и любые метаданные, необходимые для вашего конвейера текстового видео или ИИ-музыки.

Это API только для текста. Оно не генерирует аудио, видео или изображения; оно генерирует текстовые инструкции, которые управляют этими инструментами. Используйте этот эндпоинт для создания сценариев, написания текстов песен или извлечения структурированных данных из ваших творческих активов.

Copycurl https://api.sunoapis.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Python SDK

Интегрируйте API в свои Python-приложения с помощью официального SDK OpenAI. Поскольку мы совместимы с OpenAI, вы можете повторно использовать свой существующий код, просто изменив базовый URL и API-ключ.

Этот подход подходит для генерации сценариев для инструментов создания видео или написания метаданных для музыкальных API. Убедитесь, что версия вашего SDK обновлена, чтобы поддерживать функции потоковой передачи и вызова функций, описанные в следующих разделах.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.sunoapis.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

Node SDK

Для разработчиков JavaScript/TypeScript пакет @anthropic-ai/sdk или официальный пакет openai работают с незначительными изменениями конфигурации. Укажите базовый URL в клиенте и используйте идентификатор модели uncensored.

Это позволяет вам создавать генерацию текста на стороне сервера для ваших творческих приложений. Вы можете использовать это для предварительной обработки пользовательских вводов или постобработки сгенерированных сценариев перед отправкой их в эндпоинты генерации аудио или видео. API возвращает стандартные JSON-ответы, совместимые с современными веб-фреймворками.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.sunoapis.com/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

Потоковые ответы

Для длинных сценариев или подробных метаданных используйте Server-Sent Events (SSE), чтобы получать токены в реальном времени. Установите stream: true в теле запроса. API будет отправлять серию фрагментов, позволяя отображать текст по мере его генерации.

Это особенно полезно для интерактивных творческих инструментов, где пользователи хотят видеть, как промпт развивается по мере его написания. Каждый фрагмент содержит только добавленный текст, поэтому вам необходимо объединить фрагменты, чтобы восстановить полный ответ.

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

Лимиты, ошибки и контекст

Каждый аккаунт ограничен одним API-ключом, который можно перегенерировать в любое время (старый ключ аннулируется). Вам разрешено 300 запросов в минуту на ключ, с максимальным размером тела запроса 8 МБ.

Распространённые ошибки: 401 при недействительном API-ключе, 402 при недостатке предоплаченного баланса и 429 при достижении лимита запросов. Модель поддерживает контекстное окно на 100 000 токенов для суммарного ввода и вывода.

Примечание о контенте: Модель не отказывает в спорных или взрослых темах, но строго блокирует сексуальный контент с участием несовершеннолетних во всех запросах.