AdVizion

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.

Sign in to reveal or refresh your API 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/Ad Copilot: build an editable brief; generation requires the returned quote and explicit confirmation.
  • POST/advertisement_analysis/First-pass AdVizion AI Coach on uploaded images.

Image & Video Generation

  • GET/api/generation/capabilitiesRead supported media, output sizes, and source-edit availability.
  • POST/api/generation/image-quoteBind an image quote to variant count, size, analysis and creation context.
  • POST/api/generation/video-quoteQuote a scenario, render, composition or supported source edit.
  • GET/api/generation/operations/{id}Resume a saved generation operation without resubmitting paid work.
  • POST/api/generation/operations/{id}/cancelRequest cancellation and reconcile any already accepted provider work.
  • 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

  • POST/api/v2/brief-importsExtract PDF or DOCX sources into an editable brief and Brand Rules with provenance and conflicts.
  • POST/api/v2/brief-imports/{id}/confirmConfirm the reviewed revision before creating or updating project context.
  • POST/api/v2/creation-draftsSave a revisioned creation brief, exact source versions and operation reference.
  • 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/capabilitiesVerify account eligibility before native creation or launch.
  • POST/api/google-ads/deploys/{id}/actionsOwner-approved native launch, pause or bounded budget changes with a verified campaign and current review.
  • POST/api/google-ads/deploys/{id}/reconcileReconcile asynchronous uploads and uncertain provider requests.
  • POST/api/google-ads/deploys/{id}/optimization-proposalsCreate an evidence-linked editable proposal. Generation and ad replacement each require separate confirmation.
  • 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/deployPrepare supported paused Demand Gen image or video campaigns when native capability checks pass. Unsupported handoffs are labeled separately.
  • 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,
});