🔑 Авторизация API CloudAI

🚀 Быстрый старт

1. 🔐 Зарегистрируйтесь или войдите

Создайте аккаунт или войдите в существующий на frzcloud.ru

2. 🎫 Получите API токен

Перейдите в дашборд и создайте ваш персональный токен

3. 🚀 Используйте токен в запросах

curl -X POST https://api.frzcloud.ru/api/public/v1/chat/completions \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "endpoint_code": "cloud_chat",
    "model": "gpt-4o",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

4. 🎉 Готово!

Теперь вы можете использовать все возможности CloudAI API.

🌐 Базовый URL

# Основной API URL для всех запросов
https://api.frzcloud.ru/api/public/v1

📋 Как получить ваш API токен

Через дашборд CloudAI

Зайдите на frzcloud.ru
Зарегистрируйтесь или войдите в систему
Перейдите в раздел "API токены" или "Настройки"
Нажмите "Создать токен"
Скопируйте ваш токен в формате sk-...

Формат токена

Ваш токен будет выглядеть примерно так:

sk-abc123def456ghi789jkl012mno345pqr678stu

⚠️ Важно:

Храните токен в безопасности
Не делитесь им с посторонними
При компрометации токена создайте новый в дашборде

🔐 Использование API токена

В заголовке Authorization (рекомендуемый способ)

curl -X POST https://api.frzcloud.ru/api/public/v1/chat/completions \
  -H "Authorization: Bearer sk-ваш_токен_здесь" \
  -H "Content-Type: application/json" \
  -d '{
    "endpoint_code": "cloud_chat",
    "model": "gpt-4o",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

В URL параметре (альтернативный способ)

curl -X POST "https://api.frzcloud.ru/api/public/v1/chat/completions?token=sk-ваш_токен_здесь" \
  -H "Content-Type: application/json" \
  -d '{
    "endpoint_code": "cloud_chat",
    "model": "gpt-4o",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

📋 Примеры использования API

Чат с ИИ

curl -X POST https://api.frzcloud.ru/api/public/v1/chat/completions \
  -H "Authorization: Bearer sk-ваш_токен_здесь" \
  -H "Content-Type: application/json" \
  -d '{
    "endpoint_code": "cloud_chat",
    "model": "gpt-4o",
    "messages": [
      {"role": "user", "content": "Напиши краткую историю о космосе"}
    ],
    "temperature": 0.7,
    "max_tokens": 500
  }'

Генерация изображений

curl -X POST https://api.frzcloud.ru/api/public/v1/images/generations \
  -H "Authorization: Bearer sk-ваш_токен_здесь" \
  -H "Content-Type: application/json" \
  -d '{
    "endpoint_code": "frzcloud_tgter",
    "model": "sdxl-turbo",
    "prompt": "красивый закат над горами",
    "size": "1024x1024"
  }'

Получение списка доступных моделей

curl -X GET "https://api.frzcloud.ru/api/public/v1/endpoints/cloud_chat/models" \
  -H "Authorization: Bearer sk-ваш_токен_здесь"

⚠️ Обработка ошибок

Возможные проблемы и решения

Код ошибки	Описание	Решение
`401`	Неверный или отсутствующий токен	Проверьте правильность токена в заголовке Authorization
`402`	Недостаточно средств или лимита	Пополните баланс в дашборде
`429`	Превышен лимит запросов	Подождите немного и повторите запрос
`400`	Неподдерживаемый эндпоинт или модель	Проверьте правильность endpoint_code и model
`500`	Внутренняя ошибка сервера	Повторите запрос позже или обратитесь в поддержку

Пример ответа с ошибкой

{
  "error": {
    "code": "payment_required",
    "message": "Недостаточно средств или лимита"
  }
}

🔒 Безопасность токенов

📋 Правила безопасного использования

🔐 Храните токен в безопасности - не делитесь им с посторонними
🔄 Регулярно обновляйте токен - создавайте новый в дашборде при подозрении на компрометацию
🌐 Используйте HTTPS - всегда отправляйте запросы по защищенному протоколу
📱 Не храните в коде - используйте переменные окружения или защищенное хранилище
🔍 Мониторьте использование - регулярно проверяйте активность токена в дашборде

🚨 Признаки компрометации токена

Неожиданные запросы в истории использования
Внезапное исчерпание лимитов
Неавторизованный доступ к вашему аккаунту

При подозрении на компрометацию:

Создайте новый токен в дашборде
Удалите старый токен
Обратитесь в поддержку если подозреваете взлом аккаунта

💻 Интеграция с популярными языками

JavaScript/Node.js

const CLOUD_AI_TOKEN = 'sk-ваш_токен_здесь';

async function chatWithAI(message) {
  const response = await fetch('https://api.frzcloud.ru/api/public/v1/chat/completions', {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${CLOUD_AI_TOKEN}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      endpoint_code: 'cloud_chat',
      model: 'gpt-4o',
      messages: [{ role: 'user', content: message }],
      temperature: 0.7
    })
  });

  const data = await response.json();
  return data.choices[0].message.content;
}

// Использование
chatWithAI('Привет! Расскажи о себе.').then(console.log);

Python

import requests
import os

# Лучше хранить токен в переменной окружения
CLOUD_AI_TOKEN = os.getenv('CLOUD_AI_TOKEN', 'sk-ваш_токен_здесь')

def chat_with_ai(message):
    headers = {
        'Authorization': f'Bearer {CLOUD_AI_TOKEN}',
        'Content-Type': 'application/json'
    }

    data = {
        'endpoint_code': 'cloud_chat',
        'model': 'gpt-4o',
        'messages': [{'role': 'user', 'content': message}],
        'temperature': 0.7
    }

    response = requests.post(
        'https://api.frzcloud.ru/api/public/v1/chat/completions',
        json=data,
        headers=headers
    )

    return response.json()['choices'][0]['message']['content']

# Использование
print(chat_with_ai('Привет! Расскажи о себе.'))

PHP

<?php

$CLOUD_AI_TOKEN = 'sk-ваш_токен_здесь';

function chatWithAI($message) {
    $url = 'https://api.frzcloud.ru/api/public/v1/chat/completions';
    $data = [
        'endpoint_code' => 'cloud_chat',
        'model' => 'gpt-4o',
        'messages' => [['role' => 'user', 'content' => $message]],
        'temperature' => 0.7
    ];

    $context = stream_context_create([
        'http' => [
            'method' => 'POST',
            'header' => [
                'Authorization: Bearer ' . CLOUD_AI_TOKEN,
                'Content-Type: application/json'
            ],
            'content' => json_encode($data)
        ]
    ]);

    $result = file_get_contents($url, false, $context);
    $response = json_decode($result, true);

    return $response['choices'][0]['message']['content'];
}

// Использование
echo chatWithAI('Привет! Расскажи о себе.');

📞 Поддержка

Как получить помощь

📧 Email: admin@frzcloud.ru

Часто задаваемые вопросы

❓ Где найти мой токен?

В дашборде CloudAI в разделе "API токены" или "Настройки"

❓ Токен не работает, что делать?

Проверьте:

Правильность токена
Заголовок Authorization
Наличие средств на балансе
Правильность endpoint_code

❓ Как пополнить баланс?

В дашборде перейдите в раздел "Баланс" или "Тарифы"

❓ Можно ли использовать несколько токенов?

Всего можно создать и использовать один токен, создание нового заменяет старый.

Полный список доступных эндпоинтов и моделей:

curl -X GET "https://api.frzcloud.ru/api/public/v1/models" \

🚀 Быстрый старт​

1. 🔐 Зарегистрируйтесь или войдите​

2. 🎫 Получите API токен​

3. 🚀 Используйте токен в запросах​

4. 🎉 Готово!​

🌐 Базовый URL​

📋 Как получить ваш API токен​

Через дашборд CloudAI​

Формат токена​

🔐 Использование API токена​

В заголовке Authorization (рекомендуемый способ)​

В URL параметре (альтернативный способ)​

📋 Примеры использования API​

Чат с ИИ​

Генерация изображений​

Получение списка доступных моделей​

⚠️ Обработка ошибок​

Возможные проблемы и решения​

Пример ответа с ошибкой​

🔒 Безопасность токенов​

📋 Правила безопасного использования​

🚨 Признаки компрометации токена​

💻 Интеграция с популярными языками​

JavaScript/Node.js​

Python​

PHP​

📞 Поддержка​

Как получить помощь​

Часто задаваемые вопросы​