Документация Ropewalk API и MCP-сервера

Аутентификация

Каждый запрос требует личный API-ключ в заголовке Authorization: "Authorization: Bearer rw_live_…". Создавайте и отзывайте ключи в Настройки → API (до 10 на аккаунт).

Ключ действует от имени вашего аккаунта и тратит ваш кошелёк. Храните его на сервере и никогда не встраивайте в код браузера или мобильного приложения.

curl http://ru.ropewalk.ai/api/v1/models -H "Authorization: Bearer rw_live_YOUR_KEY"

Цены и оплата

Любая модель стоит 50% от цены в приложении, в монетах (1 доллар пополнения = 1000 монет). Цены отдаёт GET /v1/models: за миллион токенов для текстовых моделей и стартовая цена ("from") для медиамоделей, где цена зависит от настроек.

Текст: при старте резервируется вход плюс лимит ответа, после ответа неиспользованная часть возвращается — вы платите за фактические токены. usage.cost_coins в ответе показывает итоговое списание.

Медиа: цена выбранных настроек резервируется при старте и уточняется после завершения задачи. Неудачные задачи возвращаются полностью. Все списания видны в истории кошелька как «API usage».

Модели

GET /v1/models возвращает модели, доступные через API. У каждой есть id (используйте как "model"), type, generation_types, pricing, settings (ключи, варианты, значения по умолчанию, границы) и inputs (входные файлы, например референсное изображение). GET /v1/models/{id} возвращает одну модель; id может содержать "/".

Настройки и файлы

Медиамодели принимают три вещи: промпт, настройки (соотношение сторон, длительность, качество, число картинок…) и входные файлы — например, референсное изображение, первый кадр или образец голоса. Каждая модель перечисляет свои ключи настроек с вариантами и значениями по умолчанию и ключи входов с допустимыми типами файлов в GET /v1/models/{id}. Там же есть поле "example" с готовым запросом.

Не указанные настройки берутся по умолчанию. Входы принимают публичную ссылку на файл или id файла, загруженного через POST /v1/files (multipart, до 50 МБ) — так передаются файлы с компьютера. Выберите модель ниже, чтобы увидеть её настройки и входы и получить готовый запрос.

# 1. Upload a file from your computer
curl http://ru.ropewalk.ai/api/v1/files -H "Authorization: Bearer rw_live_YOUR_KEY" -F "file=@photo.jpg"
# → {"id": "6721…", "object": "file", "type": "image", "url": "https://…"}

# 2. Put its id into the model's input (input keys: GET /v1/models/{id} → inputs)
curl http://ru.ropewalk.ai/api/v1/generations \
  -H "Authorization: Bearer rw_live_YOUR_KEY" -H "Content-Type: application/json" \
  -d '{"model": "black-forest-labs/flux-3-image", "prompt": "Turn it into an anime poster", "inputs": {"image": "6721…"}}'

Chat completions

POST /v1/chat/completions повторяет формат OpenAI: model, messages (system/developer, user, assistant; текст), max_tokens или max_completion_tokens, temperature, top_p и stream. Изображения в сообщениях пока не поддерживаются.

С stream: true ответ приходит стандартными событиями chat.completion.chunk и [DONE] после того, как он полностью готов.

from openai import OpenAI

client = OpenAI(base_url="http://ru.ropewalk.ai/api/v1", api_key="rw_live_YOUR_KEY")

reply = client.chat.completions.create(
    model="thinkingmachines/inkling",
    messages=[{"role": "user", "content": "Write a tagline for a coffee shop"}],
)
print(reply.choices[0].message.content)
print(reply.usage)  # includes cost_coins

Изображения, видео, аудио и 3D

POST /v1/generations запускает задачу: {"model", "prompt", "settings": {ключ: значение}, "inputs": {ключ: url}}. Ключи настроек и входов — из GET /v1/models/{id}. Входы принимают публичные ссылки на файлы (или массивы ссылок для входов с несколькими файлами).

Ответ — 202 с задачей. Опрашивайте GET /v1/generations/{id}, пока статус не станет "succeeded" (output.url, действует час) или "failed" (error, монеты возвращены).

curl http://ru.ropewalk.ai/api/v1/generations \
  -H "Authorization: Bearer rw_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "black-forest-labs/flux-3-image", "prompt": "A red fox in the snow, cinematic light"}'

# → {"id": "6720…", "status": "queued", ...}

curl http://ru.ropewalk.ai/api/v1/generations/6720… -H "Authorization: Bearer rw_live_YOUR_KEY"
# → {"status": "succeeded", "output": {"url": "https://…"}, "cost_coins": 100}

MCP-сервер

Ваш личный MCP-сервер доступен по адресу /v1/mcp (Streamable HTTP) с тем же ключом. Инструменты: list_models, get_model, chat, generate (ждёт до ~100 с, затем возвращает id задачи), upload_file, get_generation и get_balance. Цены, возвраты и лимиты — как в REST API.

Приложения входят через OAuth: добавьте адрес сервера, приложение откроет страницу Ropewalk, вы входите и нажимаете «Разрешить» — копировать ключ не нужно. Каждое подключённое приложение получает свой ключ в Настройки → API, его можно отозвать. Клиенты без OAuth могут передавать «Authorization: Bearer rw_live_…» или использовать личную ссылку /v1/mcp/<ключ>. Пошаговые инструкции для каждого приложения — на странице MCP.

claude mcp add --transport http ropewalk http://ru.ropewalk.ai/api/v1/mcp

{
  "mcpServers": {
    "ropewalk": {
      "url": "http://ru.ropewalk.ai/api/v1/mcp"
    }
  }
}

{
  "mcpServers": {
    "ropewalk": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "http://ru.ropewalk.ai/api/v1/mcp"
      ]
    }
  }
}

Ошибки и лимиты

Ошибки в формате OpenAI: {"error": {"message", "type", "code"}}. 400 — неверный запрос, 401 — нет ключа или он отозван, 402 — недостаточно монет, 403 — модель доступна после первого пополнения или подписки, 404 — неизвестная модель или задача, 429 — превышен лимит.

Лимиты на ключ: 120 запросов в минуту и 5 одновременно выполняемых медиагенераций.