CodexbaseAIHub Docs

curl -X POST https://your-domain.com/api/v1/image/generate \
  -H "X-API-Key: cxb_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "example text"}'

import requests

response = requests.post(
    "https://your-domain.com/api/v1/image/generate",
    headers={"X-API-Key": "cxb_your_key_here"},
    json={
  "prompt": "example text"
}
)
print(response.json())

const response = await fetch("https://your-domain.com/api/v1/image/generate", {
  method: "POST",
  headers: {
    "X-API-Key": "cxb_your_key_here",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({"prompt": "example text"})
});
const data = await response.json();
console.log(data);

payload := {
  "prompt": "example text"
}
body, _ := json.Marshal(payload)
req, _ := http.NewRequest("POST", "https://your-domain.com/api/v1/image/generate", bytes.NewBuffer(body))
req.Header.Set("X-API-Key", "cxb_your_key_here")
req.Header.Set("Content-Type", "application/json")
resp, _ := http.DefaultClient.Do(req)

curl -X POST https://your-domain.com/api/v1/sentiment/analyze \
  -H "X-API-Key: cxb_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"text": "example text"}'

import requests

response = requests.post(
    "https://your-domain.com/api/v1/sentiment/analyze",
    headers={"X-API-Key": "cxb_your_key_here"},
    json={
  "text": "example text"
}
)
print(response.json())

const response = await fetch("https://your-domain.com/api/v1/sentiment/analyze", {
  method: "POST",
  headers: {
    "X-API-Key": "cxb_your_key_here",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({"text": "example text"})
});
const data = await response.json();
console.log(data);

payload := {
  "text": "example text"
}
body, _ := json.Marshal(payload)
req, _ := http.NewRequest("POST", "https://your-domain.com/api/v1/sentiment/analyze", bytes.NewBuffer(body))
req.Header.Set("X-API-Key", "cxb_your_key_here")
req.Header.Set("Content-Type", "application/json")
resp, _ := http.DefaultClient.Do(req)

curl -X POST https://your-domain.com/api/v1/text/generate \
  -H "X-API-Key: cxb_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "example text"}'

import requests

response = requests.post(
    "https://your-domain.com/api/v1/text/generate",
    headers={"X-API-Key": "cxb_your_key_here"},
    json={
  "prompt": "example text"
}
)
print(response.json())

const response = await fetch("https://your-domain.com/api/v1/text/generate", {
  method: "POST",
  headers: {
    "X-API-Key": "cxb_your_key_here",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({"prompt": "example text"})
});
const data = await response.json();
console.log(data);

payload := {
  "prompt": "example text"
}
body, _ := json.Marshal(payload)
req, _ := http.NewRequest("POST", "https://your-domain.com/api/v1/text/generate", bytes.NewBuffer(body))
req.Header.Set("X-API-Key", "cxb_your_key_here")
req.Header.Set("Content-Type", "application/json")
resp, _ := http.DefaultClient.Do(req)

curl -X POST https://your-domain.com/api/v1/nexus/chat \
  -H "X-API-Key: cxb_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"message": "What were the main risks in the report I sent?"}'

import requests

response = requests.post(
    "https://your-domain.com/api/v1/nexus/chat",
    headers={"X-API-Key": "cxb_your_key_here"},
    json={
  "message": "What were the main risks in the report I sent?"
}
)
print(response.json())

const response = await fetch("https://your-domain.com/api/v1/nexus/chat", {
  method: "POST",
  headers: {
    "X-API-Key": "cxb_your_key_here",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({"message": "What were the main risks in the report I sent?"})
});
const data = await response.json();
console.log(data);

payload := {
  "message": "What were the main risks in the report I sent?"
}
body, _ := json.Marshal(payload)
req, _ := http.NewRequest("POST", "https://your-domain.com/api/v1/nexus/chat", bytes.NewBuffer(body))
req.Header.Set("X-API-Key", "cxb_your_key_here")
req.Header.Set("Content-Type", "application/json")
resp, _ := http.DefaultClient.Do(req)

curl -X POST https://your-domain.com/api/v1/code/assist \
  -H "X-API-Key: cxb_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"action": "example text"}'

import requests

response = requests.post(
    "https://your-domain.com/api/v1/code/assist",
    headers={"X-API-Key": "cxb_your_key_here"},
    json={
  "action": "example text"
}
)
print(response.json())

const response = await fetch("https://your-domain.com/api/v1/code/assist", {
  method: "POST",
  headers: {
    "X-API-Key": "cxb_your_key_here",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({"action": "example text"})
});
const data = await response.json();
console.log(data);

payload := {
  "action": "example text"
}
body, _ := json.Marshal(payload)
req, _ := http.NewRequest("POST", "https://your-domain.com/api/v1/code/assist", bytes.NewBuffer(body))
req.Header.Set("X-API-Key", "cxb_your_key_here")
req.Header.Set("Content-Type", "application/json")
resp, _ := http.DefaultClient.Do(req)

curl -X POST https://your-domain.com/api/v1/grok/chat \
  -H "X-API-Key: cxb_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"message": "example text"}'

import requests

response = requests.post(
    "https://your-domain.com/api/v1/grok/chat",
    headers={"X-API-Key": "cxb_your_key_here"},
    json={
  "message": "example text"
}
)
print(response.json())

const response = await fetch("https://your-domain.com/api/v1/grok/chat", {
  method: "POST",
  headers: {
    "X-API-Key": "cxb_your_key_here",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({"message": "example text"})
});
const data = await response.json();
console.log(data);

payload := {
  "message": "example text"
}
body, _ := json.Marshal(payload)
req, _ := http.NewRequest("POST", "https://your-domain.com/api/v1/grok/chat", bytes.NewBuffer(body))
req.Header.Set("X-API-Key", "cxb_your_key_here")
req.Header.Set("Content-Type", "application/json")
resp, _ := http.DefaultClient.Do(req)

curl -X POST https://your-domain.com/api/v1/medical/analyze \
  -H "X-API-Key: cxb_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"text": "HbA1c: 8.2% (High). Fasting glucose: 185 mg/dL. LDL: 142 mg/dL."}'

import requests

response = requests.post(
    "https://your-domain.com/api/v1/medical/analyze",
    headers={"X-API-Key": "cxb_your_key_here"},
    json={
  "text": "HbA1c: 8.2% (High). Fasting glucose: 185 mg/dL. LDL: 142 mg/dL."
}
)
print(response.json())

const response = await fetch("https://your-domain.com/api/v1/medical/analyze", {
  method: "POST",
  headers: {
    "X-API-Key": "cxb_your_key_here",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({"text": "HbA1c: 8.2% (High). Fasting glucose: 185 mg/dL. LDL: 142 mg/dL."})
});
const data = await response.json();
console.log(data);

payload := {
  "text": "HbA1c: 8.2% (High). Fasting glucose: 185 mg/dL. LDL: 142 mg/dL."
}
body, _ := json.Marshal(payload)
req, _ := http.NewRequest("POST", "https://your-domain.com/api/v1/medical/analyze", bytes.NewBuffer(body))
req.Header.Set("X-API-Key", "cxb_your_key_here")
req.Header.Set("Content-Type", "application/json")
resp, _ := http.DefaultClient.Do(req)

curl -X POST https://your-domain.com/api/v1/product-tools/describe \
  -H "X-API-Key: cxb_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

import requests

response = requests.post(
    "https://your-domain.com/api/v1/product-tools/describe",
    headers={"X-API-Key": "cxb_your_key_here"},
    json={}
)
print(response.json())

const response = await fetch("https://your-domain.com/api/v1/product-tools/describe", {
  method: "POST",
  headers: {
    "X-API-Key": "cxb_your_key_here",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({})
});
const data = await response.json();
console.log(data);

payload := {}
body, _ := json.Marshal(payload)
req, _ := http.NewRequest("POST", "https://your-domain.com/api/v1/product-tools/describe", bytes.NewBuffer(body))
req.Header.Set("X-API-Key", "cxb_your_key_here")
req.Header.Set("Content-Type", "application/json")
resp, _ := http.DefaultClient.Do(req)

curl -X POST https://your-domain.com/api/v1/igvoice/generate \
  -H "X-API-Key: cxb_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

import requests

response = requests.post(
    "https://your-domain.com/api/v1/igvoice/generate",
    headers={"X-API-Key": "cxb_your_key_here"},
    json={}
)
print(response.json())

const response = await fetch("https://your-domain.com/api/v1/igvoice/generate", {
  method: "POST",
  headers: {
    "X-API-Key": "cxb_your_key_here",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({})
});
const data = await response.json();
console.log(data);

payload := {}
body, _ := json.Marshal(payload)
req, _ := http.NewRequest("POST", "https://your-domain.com/api/v1/igvoice/generate", bytes.NewBuffer(body))
req.Header.Set("X-API-Key", "cxb_your_key_here")
req.Header.Set("Content-Type", "application/json")
resp, _ := http.DefaultClient.Do(req)

curl -X POST https://your-domain.com/api/v1/text-classification/classify \
  -H "X-API-Key: cxb_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"model_key": "codexbase/tc_user_myshop", "text": "wireless noise-cancelling headphones 30hr battery"}'

import requests

response = requests.post(
    "https://your-domain.com/api/v1/text-classification/classify",
    headers={"X-API-Key": "cxb_your_key_here"},
    json={
  "model_key": "codexbase/tc_user_myshop",
  "text": "wireless noise-cancelling headphones 30hr battery"
}
)
print(response.json())

const response = await fetch("https://your-domain.com/api/v1/text-classification/classify", {
  method: "POST",
  headers: {
    "X-API-Key": "cxb_your_key_here",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({"model_key": "codexbase/tc_user_myshop", "text": "wireless noise-cancelling headphones 30hr battery"})
});
const data = await response.json();
console.log(data);

payload := {
  "model_key": "codexbase/tc_user_myshop",
  "text": "wireless noise-cancelling headphones 30hr battery"
}
body, _ := json.Marshal(payload)
req, _ := http.NewRequest("POST", "https://your-domain.com/api/v1/text-classification/classify", bytes.NewBuffer(body))
req.Header.Set("X-API-Key", "cxb_your_key_here")
req.Header.Set("Content-Type", "application/json")
resp, _ := http.DefaultClient.Do(req)

curl -X POST https://your-domain.com/api/v1/labwise/interpret \
  -H "X-API-Key: cxb_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

import requests

response = requests.post(
    "https://your-domain.com/api/v1/labwise/interpret",
    headers={"X-API-Key": "cxb_your_key_here"},
    json={}
)
print(response.json())

const response = await fetch("https://your-domain.com/api/v1/labwise/interpret", {
  method: "POST",
  headers: {
    "X-API-Key": "cxb_your_key_here",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({})
});
const data = await response.json();
console.log(data);

payload := {}
body, _ := json.Marshal(payload)
req, _ := http.NewRequest("POST", "https://your-domain.com/api/v1/labwise/interpret", bytes.NewBuffer(body))
req.Header.Set("X-API-Key", "cxb_your_key_here")
req.Header.Set("Content-Type", "application/json")
resp, _ := http.DefaultClient.Do(req)

curl -X POST https://your-domain.com/api/v1/gpt/chat \
  -H "X-API-Key: cxb_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"message": "example text"}'

import requests

response = requests.post(
    "https://your-domain.com/api/v1/gpt/chat",
    headers={"X-API-Key": "cxb_your_key_here"},
    json={
  "message": "example text"
}
)
print(response.json())

const response = await fetch("https://your-domain.com/api/v1/gpt/chat", {
  method: "POST",
  headers: {
    "X-API-Key": "cxb_your_key_here",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({"message": "example text"})
});
const data = await response.json();
console.log(data);

payload := {
  "message": "example text"
}
body, _ := json.Marshal(payload)
req, _ := http.NewRequest("POST", "https://your-domain.com/api/v1/gpt/chat", bytes.NewBuffer(body))
req.Header.Set("X-API-Key", "cxb_your_key_here")
req.Header.Set("Content-Type", "application/json")
resp, _ := http.DefaultClient.Do(req)

POST /api/v1/product-tools/describe
Content-Type: application/json
X-API-Key: cxb_your_key_here

{
  "image_url": "https://example.com/product.jpg",

  "tone": "content creator",
  "instructions": "Focus on the eco-friendly materials and premium feel",

  "category_list": ["Fashion", "Tech", "Home & Living", "Sports", "Beauty"],

  "validation_checks": [
    "is this a selfie or close-up portrait?",
    "contains adult or 18+ content?",
    "shows a physical product for sale?",
    "is this an invoice or receipt?"
  ]
}

POST /api/v1/product-tools/describe
Content-Type: application/json
X-API-Key: cxb_your_key_here

{
  "image_base64": "/9j/4AAQSkZJRgABAQEAAA...",

  "tone": "business professional",
  "instructions": "This is a product for B2B clients. Emphasise ROI.",
  "category_list": ["Tech", "SaaS", "Enterprise"],
  "validation_checks": ["is this a screenshot of an app?", "shows a dashboard?"]
}

# Use the correct field for each input type:
# image  → "image_base64"
# video  → "video_base64"
# PDF    → "pdf_base64"
# audio  → "audio_b64"
# code   → "code_base64"  OR  "code" (raw string)

POST /api/v1/product-tools/describe/file
Content-Type: multipart/form-data
X-API-Key: cxb_your_key_here

file              = @product.jpg              # required — image/video/pdf/audio/code
tone              = content creator           # optional
instructions      = Focus on premium quality  # optional
category_list     = ["Fashion","Tech"]        # optional — JSON array string
validation_checks = is this a selfie?|contains adult content|shows a product?

# curl:
curl -X POST https://your-domain.com/api/v1/product-tools/describe/file \
  -H "X-API-Key: cxb_your_key_here" \
  -F "file=@product.jpg" \
  -F "tone=content creator" \
  -F "category_list=[\"Fashion\",\"Tech\"]" \
  -F "validation_checks=is this a selfie?|contains adult content?"

import requests, base64

API_KEY = "cxb_your_key_here"
BASE    = "https://your-domain.com"

# ── URL input ──────────────────────────────────────────────────────
r = requests.post(f"{BASE}/api/v1/product-tools/describe",
    headers={"X-API-Key": API_KEY},
    json={
        "image_url": "https://example.com/product.jpg",
        "tone": "content creator",
        "instructions": "Focus on eco-friendly materials",
        "category_list": ["Fashion", "Tech", "Home & Living"],
        "validation_checks": [
            "is this a selfie?",
            "contains adult content?",
            "shows a product for sale?"
        ]
    })
data = r.json()["data"]
print(data["content_type"])             # "professional headshot of a man..."
print(data["spotlight"])                # "Crisp headshot for a confident..."
print(data["descriptions"][0])          # first description string
print(data["descriptions"])             # list of 5 description strings
print(data["names"])                    # list of 5 name/title strings
print(data["hashtags"])                 # list of 15 hashtag strings
print(data["category"])                 # "Photography" (matched from category_list)
for chk in data["validation_checks"]:  # iterate validation results
    print(chk["check"], "→", chk["result"], f"({chk['confidence']})")
    print("  ", chk["explanation"])

# ── Base64 input (no public URL available) ─────────────────────────
with open("product.jpg", "rb") as f:
    b64 = base64.b64encode(f.read()).decode()
r2 = requests.post(f"{BASE}/api/v1/product-tools/describe",
    headers={"X-API-Key": API_KEY},
    json={"image_base64": b64, "tone": "luxury brand"})

# ── File upload ────────────────────────────────────────────────────
with open("product.jpg", "rb") as f:
    r3 = requests.post(f"{BASE}/api/v1/product-tools/describe/file",
        headers={"X-API-Key": API_KEY},
        files={"file": ("product.jpg", f, "image/jpeg")},
        data={
            "tone": "content creator",
            "category_list": '["Fashion","Tech"]',
            "validation_checks": "is this a selfie?|contains adult content?"
        })

const API_KEY = "cxb_your_key_here";
const BASE    = "https://your-domain.com";

// ── URL input ──────────────────────────────────────────────────────
const res = await fetch(`${BASE}/api/v1/product-tools/describe`, {
  method: "POST",
  headers: { "X-API-Key": API_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({
    image_url: "https://example.com/product.jpg",
    tone: "content creator",
    instructions: "Focus on eco-friendly materials",
    category_list: ["Fashion", "Tech", "Home & Living"],
    validation_checks: [
      "is this a selfie?",
      "contains adult content?",
      "shows a product for sale?"
    ]
  })
});
const { data } = await res.json();
console.log(data.content_type);         // what AI identified
console.log(data.spotlight);            // punchy headline
console.log(data.descriptions);         // ["desc1", "desc2", "desc3", "desc4", "desc5"]
console.log(data.names);                // ["name1", "name2", "name3", "name4", "name5"]
console.log(data.hashtags);             // ["#tag1", ..., "#tag15"]
console.log(data.category);             // matched category or null
data.validation_checks.forEach(c => {
  console.log(`${c.check} → ${c.result} (${c.confidence}): ${c.explanation}`);
});

// ── File upload (browser) ──────────────────────────────────────────
const fd = new FormData();
fd.append("file", fileInputEl.files[0]);
fd.append("tone", "content creator");
fd.append("category_list", JSON.stringify(["Fashion","Tech"]));
fd.append("validation_checks", "is this a selfie?|contains adult content?");
const res2 = await fetch(`${BASE}/api/v1/product-tools/describe/file`, {
  method: "POST",
  headers: { "X-API-Key": API_KEY },
  body: fd
});

# URL input — all parameters
curl -X POST https://your-domain.com/api/v1/product-tools/describe \
  -H "X-API-Key: cxb_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://example.com/product.jpg",
    "tone": "content creator",
    "instructions": "Focus on eco-friendly materials",
    "category_list": ["Fashion", "Tech", "Home & Living"],
    "validation_checks": ["is this a selfie?", "contains adult content?"]
  }'

# Base64 image
B64=$(base64 -i product.jpg | tr -d "\n")
curl -X POST https://your-domain.com/api/v1/product-tools/describe \
  -H "X-API-Key: cxb_your_key_here" \
  -H "Content-Type: application/json" \
  -d "{\"image_base64\":\"$B64\",\"tone\":\"luxury brand\"}"

# File upload
curl -X POST https://your-domain.com/api/v1/product-tools/describe/file \
  -H "X-API-Key: cxb_your_key_here" \
  -F "file=@product.jpg" \
  -F "tone=content creator" \
  -F "category_list=[\"Fashion\",\"Tech\"]" \
  -F "validation_checks=is this a selfie?|contains adult content?"