NightVeil API

https://nightveil.ai/v1

Authorization: Bearer nv_your_key_here

from openai import OpenAI

client = OpenAI(base_url="https://nightveil.ai/v1", api_key="nv_your_key_here")

resp = client.chat.completions.create(
    model="veil-large",
    messages=[{"role": "user", "content": "Say it plainly."}],
    max_tokens=256,
)
print(resp.choices[0].message.content)

import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://nightveil.ai/v1", apiKey: process.env.NIGHTVEIL_API_KEY });

const r = await client.chat.completions.create({
  model: "veil-large",
  messages: [{ role: "user", content: "Say it plainly." }],
  max_tokens: 256,
});
console.log(r.choices[0].message.content);

curl https://nightveil.ai/v1/chat/completions \
  -H "Authorization: Bearer nv_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veil-large",
    "messages": [
      { "role": "system", "content": "You are concise." },
      { "role": "user", "content": "Say it plainly." }
    ],
    "max_tokens": 256,
    "temperature": 0.7
  }'

{
  "id": "cmpl_8f3a…",
  "object": "chat.completion",
  "model": "veil-large",
  "choices": [{
    "index": 0,
    "message": { "role": "assistant", "content": "Done." },
    "finish_reason": "stop"
  }],
  "usage": { "prompt_tokens": 19, "completion_tokens": 2, "total_tokens": 21 }
}

curl https://nightveil.ai/v1/embeddings \
  -H "Authorization: Bearer nv_your_key_here" -H "Content-Type: application/json" \
  -d '{ "model": "veil-embed", "input": "the night is private" }'

{
  "object": "list",
  "model": "veil-embed",
  "data": [{ "object": "embedding", "index": 0, "embedding": [0.0123, -0.044, …] }],
  "usage": { "prompt_tokens": 4, "total_tokens": 4 }
}

curl https://nightveil.ai/v1/images/generations \
  -H "Authorization: Bearer nv_your_key_here" -H "Content-Type: application/json" \
  -d '{ "model": "veil-diffuse-xl", "prompt": "a veiled moon", "size": "1024x1024", "quality": "high" }'

{
  "id": "img_2b…",            // re-minted by NightVeil; never the upstream id
  "images": ["<base64 or url>"],
  "created": 1733961600
}

curl https://nightveil.ai/v1/audio/speech \
  -H "Authorization: Bearer nv_your_key_here" -H "Content-Type: application/json" \
  -d '{ "model": "veil-voice", "input": "Hello from behind the veil.", "voice": "alloy" }' \
  --output speech.mp3

# 1 — enqueue
curl https://nightveil.ai/v1/video/queue \
  -H "Authorization: Bearer nv_your_key_here" -H "Content-Type: application/json" \
  -d '{ "model": "veil-motion", "prompt": "rain on neon", "duration": 5, "resolution": "720p" }'
# → { "id": "job_…", "queue_id": "q_123", "status": "QUEUED", "quote_usd": 0.42 }

# 2 — poll until terminal
curl https://nightveil.ai/v1/video/retrieve \
  -H "Authorization: Bearer nv_your_key_here" -H "Content-Type: application/json" \
  -d '{ "model": "veil-motion", "queue_id": "q_123" }'
# → { "status": "PROCESSING" }
# … then → { "status": "COMPLETED", "download_url": "/v1/video/download/job_…" }

# 3 — download (streamed through NightVeil; the upstream URL is never exposed)
curl https://nightveil.ai/v1/video/download/job_… -H "Authorization: Bearer nv_your_key_here" --output out.mp4

curl https://nightveil.ai/v1/deposit-address -H "Authorization: Bearer nv_your_key_here"
# → { "chain": "base", "asset": "usdc", "address": "0x…" }

{
  "error": {
    "code": "INSUFFICIENT_BALANCE",
    "message": "Balance 0.004 < estimate 0.01",
    "type": "billing",
    "request_id": "b1f2…"
  }
}

curl https://nightveil.ai/v1/keys \
  -H "Authorization: Bearer nv_admin_key" -H "Content-Type: application/json" \
  -d '{ "label": "customer-123" }'
# → { "id": "...", "key": "nv_…", "label": "customer-123" }

curl https://nightveil.ai/v1/usage -H "Authorization: Bearer nv_admin_key"
# → { "total_billed_usd": 12.40, "by_key": [{ "api_key_id": "...", "label": "customer-123", "requests": 88, "billed_usd": 4.10 }] }