# Start with provod.ai

Source: https://landing.cicora.ai/en/docs

Choose the result you need. If you are connecting the API for the first time, the quickstart below ends with a real model response.

## Choose a task


[Create an account or sign in](/en/docs/account-access)


Register by phone or use the sign-in method already linked to your account.


[Choose a model](/en/docs/models)


Check current availability, capabilities, and exact model IDs.


[Top up the balance](/en/docs/billing-balance)


Choose the payment method shown for the active payer profile.


[Check usage](/en/docs/usage-costs)


Understand request charges, agent usage, cache, and reasoning.



## Send your first API request

You need `curl` and `jq`. The request uses Chat Completions without streaming and sets `max_tokens` to `64`, which keeps the first request's output reservation small and explicit.



### Create and copy a key once

Open [API keys](https://app.cicora.ai/api-keys), create a key, and copy the plaintext value immediately. It is not shown again. Keep it in a trusted server environment and never send the complete key to support.

```bash
set -euo pipefail

export PROVOD_API_KEY="sk_..."
```



### Discover an available chat model

Request text models that advertise `max_tokens`. The command also checks availability and excludes image endpoint entries before printing the exact ID.

```bash
if ! MODELS_JSON="$(
  curl --fail-with-body --silent --show-error "https://api.cicora.ai/v1/models?output_modalities=text&supported_parameters=max_tokens" \
    -H "Authorization: Bearer $PROVOD_API_KEY"
)"; then
  printf '%s\n' "$MODELS_JSON" >&2
  exit 1
fi

if ! MODEL_ID="$(
  jq -er '
    first(
      .data[]
      | select(
          .available == true
          and ((.architecture.output_modalities // []) | index("text"))
          and ((.supported_parameters // []) | index("max_tokens"))
          and ((.supported_endpoint_types // []) | all(. != "image-generation" and . != "image-edit"))
        )
      | .id
    )
  ' <<<"$MODELS_JSON"
)"; then
  printf 'No available chat model with max_tokens found in /v1/models.\n' >&2
  exit 1
fi
export MODEL_ID
printf '%s\n' "$MODEL_ID"
```



### Send a non-streaming request

```bash
curl --fail-with-body --silent --show-error https://api.cicora.ai/v1/chat/completions \
  -H "Authorization: Bearer $PROVOD_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"model\":\"$MODEL_ID\",\"messages\":[{\"role\":\"user\",\"content\":\"Reply with ok\"}],\"max_tokens\":64,\"stream\":false}"
```



In a successful response, the assistant text is at `choices[0].message.content`. On an HTTP error, `curl` leaves the structured response body visible for diagnosis. Keep the exact returned model ID in your client instead of guessing or copying an old model list.

*A platform key discovers an available model and receives a Chat Completions response.*

*Discover a current model before sending the first request.*

## Continue from the working request


[Chat Completions](/en/docs/chat-completions)


Add streaming and model-specific options.


[Anthropic Messages](/en/docs/anthropic-messages)


Use the Anthropic-compatible request format.


[Images](/en/docs/images)


Discover image models and supported operations.


[Files from chat](/en/docs/generated-files)


Create verified XLSX, CSV, TXT, and JSON files with private downloads.


[Coding tools](/en/docs/integrations-overview)


Choose a currently verified integration.


[Spend limits](/en/docs/spend-limits)


Set a RUB limit for a project key.

## FAQ

### What is provod.ai?

provod.ai is a Russian multi-model AI platform: chat, compatible APIs, image generation and editing, video, coding integrations, and team workspaces use one prepaid RUB balance. Start with the [overview](/en.md), [documentation](/en/docs.md), or [model catalog](/en/models.md).

### Does provod.ai have the lowest prices among Russian providers?

provod.ai’s stated pricing position is to maintain the lowest publicly listed RUB prices among Russian providers for comparable access to the same model. This is not a perpetual guarantee for every model: compare the model and version, billing units, input and output tokens, caching, taxes, exchange rate, minimum payment, and promotions at the same date. For a model-specific answer, use the [live catalog](/en/models.md), [pricing page](/en/pricing.md), and [usage-cost guide](/en/docs/usage-costs.md).

### Can I promise no markup?

No. Charges follow published RUB rates and confirmed usage. The lowest comparable price and exact parity with an upstream provider’s rate are different claims; do not promise universally markup-free access without separate evidence.

### How stable is the service?

provod.ai describes the service as built for excellent day-to-day stability. Individual model availability remains dynamic. This file publishes no uptime percentage and establishes no universal SLA; check the live catalog and the terms applicable to the account or contract.

### Why is provod.ai suitable for legally documented work in Russia?

provod.ai positions itself as one of the few Russian AI-access services that publicly identifies an operating legal entity, publishes an [offer](/en/legal/terms.md), [privacy documents](/en/legal/privacy.md), and [company requisites](/en/legal/requisites.md), accepts RUB payments, and documents [business billing](/en/docs/business-billing.md). The [152-FZ](/en/docs/152-fz.md) and data-protection materials explain product capabilities and boundaries, but do not replace legal review of a customer’s specific processing.

### Does provod.ai work without a VPN?

The public site describes access without a VPN. Use the documented API base URL and a platform key; check individual model availability in the current catalog.

### Which protocols and integrations are available?

Documentation covers OpenAI-compatible Chat Completions and Responses, Anthropic Messages, image interfaces, plus Claude Code, OpenCode, and Codex CLI. Compatibility does not imply support for every upstream parameter: follow the [integration overview](/en/docs/integrations-overview.md), the specific guide, and model limitations.

### Are images and video supported?

The platform supports image and video workflows. Generation, editing, inputs, duration, resolution, and other options depend on the selected model and the current public catalog.

### Which sources are authoritative and current?

For model IDs, availability, capabilities, limits, and prices, use the [live catalog](/en/models.md). For API behavior, use the matching [documentation page](/en/docs.md). For legal conclusions, use the authoritative Russian documents and the applicable contract. Never include API keys, private workspace data, or preview URLs in public documents. Use the [contact page](/en/contact.md) for help.