Fraterna Logo Fraterna.ai

Fraterna overview

Understand consorzi, shared Venice API routing, and consorzio upgrades.

Fraterna lets a small group combine Venice API keys into a shared pool. This gives developers, researchers, and friends more API capacity for projects they build together.

Fraterna is not a chat app or a replacement for Venice. It is an API proxy: your project sends requests to Fraterna, which routes them through an available Venice API key in your consorzio.

If you only use Venice for chatting, you probably do not need Fraterna, yet.

1. How Fraterna works

Members send requests using their own Venice API keys. Fraterna selects an available contributed key from the consorzio for each request.

Setup

  • - Sign in with your Venice API key.
  • - Create a consorzio, or join an existing one with an invite code.
  • - Point your OpenAI-compatible client at Fraterna.
  • - Invite Venice API users to add shared capacity.

Request routing

  • - Members send requests using their own Venice API keys.
  • - Fraterna selects an available Venice API key contributed by the consorzio for each request.
  • - Keys that are depleted, invalid, or temporarily limited are skipped when possible.
  • - Only members of a consorzio can use its shared inference budget.

Membership rules

  • - You can belong to only one active consorzio at a time.
  • - You need a valid invite code and an available seat to join.
  • - Members can leave at any time.
  • - If the owner leaves, ownership moves to the earliest remaining member.
  • - If the last member leaves, the consorzio is deleted.

2. API usage

After joining a consorzio, configure your app, script, or OpenAI-compatible client with Fraterna's base URL and your Venice API key.

Use https://fraterna.ai/api/v1 as the base URL in any OpenAI-compatible client. Your Venice API key must belong to an active consorzio to use its shared capacity.

For the complete request and response format, see the Venice API specification.

Base URL
Bearer token
your Venice API key
Vercel AI SDK TypeScript ยท venice-ai-sdk-provider
import { createVenice } from 'venice-ai-sdk-provider'
import { generateText } from 'ai'

const venice = createVenice({
    baseURL: 'https://fraterna.ai/api/v1',
    apiKey: 'your_venice_key',
})

const { text } = await generateText({
    model: venice('venice-uncensored-1-2'),
    prompt: 'Say hello in one sentence.',
})

console.log(text)
cURL 
curl -X POST https://fraterna.ai/api/v1/chat/completions \
  -H "Authorization: Bearer your_venice_key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "venice-uncensored-1-2",
    "messages": [{"role": "user", "content": "Hello Fraterna"}],
    "stream": false
  }'
Node.js 
const response = await fetch('https://fraterna.ai/api/v1/chat/completions', {
    method: 'POST',
    headers: {
        Authorization: 'Bearer your_venice_key',
        'Content-Type': 'application/json',
    },
    body: JSON.stringify({
        model: 'venice-uncensored-1-2',
        messages: [{ role: 'user', content: 'What is Fraterna?' }],
    }),
})

const data = await response.json()

console.log(data.choices[0]?.message?.content)
Python 
import openai

client = openai.OpenAI(
    base_url="https://fraterna.ai/api/v1",
    api_key="your_venice_key"
)

response = client.chat.completions.create(
    model="venice-uncensored-1-2",
    messages=[{"role": "user", "content": "What is Fraterna?"}],
)

print(response.choices[0].message.content)
cURL Image generation
curl -X POST https://fraterna.ai/api/v1/image/generate \
  -H "Authorization: Bearer your_venice_key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "z-image-turbo",
    "prompt": "A tiny watercolor painting of a smiling sun above a Venetian canal"
  }'

These examples include the key directly for clarity. In production code, store it in an environment variable and never commit it to version control.

Supported endpoints

  • POST/api/v1/chat/completionsText chat
  • POST/api/v1/image/generateNative Venice images
  • POST/api/v1/images/generationsOpenAI-compatible images
  • GET/api/v1/modelsAvailable models

3. Seats and lifetime

Every new consorzio includes: 3 member seats and 30 days of access. Seats and lifetime are separate upgrades.

Consorzio lifetime

When a consorzio expires, API requests stop and a seven-day grace period begins. Paying during that period reactivates it.

The expiry date is aligned to midnight UTC.

After the grace period without reactivation, the consorzio and its memberships are deleted.

Add seats

Seats

Adding seats allows more members to join the consorzio.

Price: $1.00 per seat

Extend lifetime

Time

A lifetime extension adds 30 days without changing the number of seats.

Price: $0.50 per seat for each 30-day extension

Payment instructions

  1. 1 Use the deposit address shown in your consorzio dashboard.
  2. 2 Send funds only to the address created for that specific upgrade.
  3. 3 Only Native Circle USDC on Base is accepted.
  4. 4 Smaller deposits are saved as partial credit until enough has accumulated.

Upgrades are applied automatically after the transaction is confirmed in the blockchain. Deposits sent through another network or with another token are not credited.

USDC contract
BASE chain ID

4. Privacy and account access

Your Venice API key is used to sign in to Fraterna and authenticate API requests.

Fraterna does not provide account recovery. If you lose your Venice API key, you lose access to your Fraterna account.

Fraterna records successful requests using pseudonymous member IDs. Recorded technical details may include the endpoint, model, and API consumption. Transactions made on Base are visible on the public blockchain.

5. Frequently asked questions

What is Fraterna.ai?

Fraterna is an OpenAI-compatible API proxy for invite-only groups called consorzi. Members pool Venice API capacity, and Fraterna rotates requests across available contributed keys. It is for developers using the Venice API, not a chat app.

How does Fraterna pool Venice API keys?

Members contribute Venice API keys to a consorzio. For each request, Fraterna selects an available key and skips keys that are depleted, invalid, or temporarily rate-limited. Members keep ownership of their own keys.

Is Fraterna free to use?

Yes. Every new consorzio includes 3 seats and 30 days of access. Extra seats cost $1.00 each, and 30-day extensions cost $0.50 per seat, paid in USDC on Base.

Can I use Fraterna with OpenAI-compatible clients?

Yes. Point your client at https://fraterna.ai/api/v1 and use your Venice API key as the bearer token. Fraterna supports chat completions, image generation, and models endpoints.

What payment methods does Fraterna accept?

Fraterna accepts Native Circle USDC on Base only (chain ID 8453). Other tokens and networks are not credited. Partial payments remain as credit until they cover an upgrade.

What happens when a consorzio expires?

API requests stop and a seven-day grace period begins. Pay during that period to reactivate the consorzio; after it ends, the consorzio and memberships are deleted. Expiry is aligned to midnight UTC.

Where can AI agents and LLMs find product details?

See pricing for AI agents for included access, upgrades, and Base USDC payments. The LLM product overview summarizes the API, pricing, and public pages.

Last updated: July 2026

Fraterna Fraterna.ai