Developer

AdVizion API

Integrate supported image, video, audio/m4a analysis, decision reports, and generation into your stack. Compatible endpoints accept either an x-api-key header or a standard Authorization: Bearer token. Eligible grandfathered Premium subscribers and contractually scoped Enterprise customers can manage an API key below.

Your API key

Programmatic requests use the x-api-key header (not your login password). Browser sessions use Cognito Bearer tokens; API automations use this key.

Authentication

Send one of the following on every request:

x-api-key: YOUR_API_KEY
# or
Authorization: Bearer YOUR_COGNITO_ACCESS_TOKEN

The Cognito Bearer token is what the web UI uses; API keys are for scripts, automations, and CI. A key can call only the scopes granted to it, and configured usage or credit limits still apply. Rotate or revoke a key from Account when access changes.

Endpoints

Analysis

POST/api/upload/Image saliency / sequence / brand attention / complexity (multipart).
POST/api/video/Video saliency + brand attention + complexity (multipart).
POST/upload_video/Same as /api/video/ — used by the web UI.
POST/api/video_understanding/AdVizion video intelligence analysis (markdown summary).
POST/api/emotional_prediction_analysis/Emotional sentiment per image.
POST/api/customer_intent_analysis/Predicted intent action + reason.
POST/api/reverse_image_search_upload/Reverse image search + uniqueness score.
POST/api/asr_transcription/Audio / video transcription with timestamps.
POST/api/resolve_media_url/Resolve a YouTube/TikTok/IG URL to an S3 URL.

Decision Report & Chat

POST/api/decision_report/AdVizion Decision Report for an image or video.
POST/api/chat/Unified multimodal coach (image/video/asr/comparison/decision modes).
POST/api/marketing_agent/AdVizion marketing agent — chat funnel that builds ads from a brief.
POST/advertisement_analysis/First-pass AdVizion AI Coach on uploaded images.

Image & Video Generation

POST/api/ai-visual-editor/AdVizion image generation / editing.
POST/api/video_generate/scenarioAdVizion scenario writer (1-4 × 8s segments).
POST/api/video_generate/segmentRender one 8-second video segment (chained via last-frame).
POST/api/video_generate/Orchestrator — scenario + segments + concat + auto-analyze.

Projects, Decisions & Sharing

GET/api/projects/List the caller's projects.
POST/api/projects/Create a project (brief + brand + platforms).
GET/api/projects/{id}Get one project + roll-up counts.
GET/api/projects/{id}/itemsList analyses + generated versions in a project.
POST/api/projects/{id}/decisionsSave a Run/Fix/Reject decision to the project.
POST/api/projects/{id}/learningsSave a learning.
GET/api/projects/{id}/google-ads/deploysList Google Ads deploys for a project.
POST/api/share/{item_id}Create a public share link for an item.

Google Ads

GET/api/google-ads/statusIs the caller connected to Google Ads?
GET/api/google-ads/accountsList Google Ads accounts the connected Google user can access.
POST/api/google-ads/deployCreate a PAUSED video campaign draft (explicit confirmation required) and persist a deploy record. Cannot activate or spend.
GET/api/google-ads/deploysList all Google Ads deploys for the caller.
GET/api/google-ads/deploys/{id}/metricsFetch cached or live campaign metrics.
POST/api/google-ads/deploys/{id}/statusPause a campaign previously created through AdVizion. PAUSED is the only accepted status.

Campaign Decisions

GET/api/campaign-decisionsList STOP/SCALE/FIX/RELAUNCH/KEEP TESTING events.
GET/api/projects/{id}/campaign-decisionsList campaign decision events for one project.
POST/api/campaign-decisions/evaluateCreate an explicit during-campaign recommendation event.

Operator-only legacy utilities

POST/api/admin/users/{user_id}/grantOperator-only legacy entitlement migration utility; not a collaboration or membership API.
POST/api/admin/users/{user_id}/rotate-keyOperator-only legacy key rotation utility.

Base URL: production is https://advizion.ai. The Next.js front-end relays paths to FastAPI on port 8000 internally.

Operator-only legacy utilities

These preserved endpoints support controlled entitlement migration and incident recovery. They require the existing operator authorization and do not create workspace membership, invitations, assignments, or unrestricted API access:

curl -X POST \
  -H "Authorization: Bearer $ADMIN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"role":"tester","rotate_key":true}' \
  https://advizion.ai/api/admin/users/$TEAMMATE_USER_ID/grant

A successful rotation can return a one-time key secret. Transfer it through an approved secrets manager — never paste keys into chat or commit them to git. For project and workspace collaboration, use in-product email invites rather than this operator grant. Talk to sales to scope supported Enterprise access.

Examples

const formData = new FormData();
formData.append('file', fileInput.files[0]);
formData.append('prediction_type', 'saliency');
formData.append('condition', '2');

fetch('https://advizion.ai/api/upload/', {
  method: 'POST',
  headers: { 'x-api-key': 'YOUR_API_KEY' },
  body: formData,
});