Quickstart

flinq is OpenAI-compatible. The fastest path is to take a working OpenAI integration, change the base_url and the model name, and run it. The whole integration is under ten lines.

1. Get a key

   Create a key in the flinq console. It looks like flq_... and goes in the Authorization: Bearer header. New accounts start with EUR 5 of free credit. The examples below use the placeholder flq_your_key_here against the production API at https://api.flinq.ai.

2. Send your first request

   curl

   curl https://api.flinq.ai/v1/embeddings \
     -H "Authorization: Bearer flq_your_key_here" \
     -H "Content-Type: application/json" \
     -d '{
       "model": "flinq-pilot-otter",
       "input": "Beton C25/30 XC4"
     }'

   Python (OpenAI SDK)

   from openai import OpenAI
   
   client = OpenAI(base_url="https://api.flinq.ai/v1", api_key="flq_your_key_here")
   r = client.embeddings.create(
       model="flinq-pilot-wombat",
       input="Beton C25/30 XC4",
   )
   print(len(r.data[0].embedding))  # 1024

   Node (openai)

   import OpenAI from 'openai';
   
   const client = new OpenAI({
     baseURL: 'https://api.flinq.ai/v1',
     apiKey: 'flq_your_key_here',
   });
   
   const r = await client.embeddings.create({
     model: 'flinq-pilot-otter',
     input: 'Beton C25/30 XC4',
   });
   console.log(r.data[0].embedding.length); // 1024

3. Choose a dimension

   The model is Matryoshka-trained: a single forward pass produces a 1024-dim vector whose leading slice stays meaningful when truncated. Ask for dimensions of 1024, 768, 512, 256 or 128 to trade a little accuracy for smaller vectors, a smaller index and faster nearest-neighbor search. flinq truncates and re-normalizes for you.

   r = client.embeddings.create(
       model="flinq-pilot-wombat",
       input="Beton C25/30 XC4",
       dimensions=256,
   )

Try it live

Send requests against every endpoint, with schemas and example payloads, in the interactive API reference.

Where to go next

• Embeddings: the model, Matryoshka dimensions, and the two failure modes flinq is built to fix.
• Hybrid search: why the BM25 lexical leg matters for AEC.
• Examples: runnable recipes for LV matching, cost prediction, and RAG with pgvector.