01 Что такое API
API — это «контракт» между двумя системами. Одна система говорит «вот эти эндпоинты, вот формат запроса/ответа», другая использует. Большинство API в 2026 — REST: вы делаете HTTP-запрос (GET/POST/PUT/DELETE), получаете JSON.
02 Типы API в AI
- LLM API. Anthropic, OpenAI, Gemini — отправляете промпт, получаете ответ.
- Embedding API. Текст → вектор для RAG.
- Speech API. Whisper для транскрипции, ElevenLabs для синтеза.
- Image API. DALL-E, Flux, Kandinsky для генерации картинок.
- Video API. Sora, Hailuo MiniMax.
- Vector DB API. Pinecone, Qdrant для поиска по векторам.
03 Как работать с API
- Зарегистрироваться у провайдера, получить API-ключ.
- Положить ключ в
.envили secrets manager (не в код!). - Сделать HTTP-запрос с заголовком Authorization.
- Обработать ответ (обычно JSON).
- Обработать ошибки: rate limit, timeout, 5xx.
04 Безопасность
- API-ключи — никогда в git.
.envв.gitignore. - Rate limit на свой API — против abuse.
- Логирование запросов — для аудита и debug.
- Идемпотентность critical-операций — повтор не должен ломать.