Skip to content
96Astro API
Get API Key

Face reading

Available

Face: Outline Traced API

The outline of the face and its features traced on a photo, with an SVG overlay to lay over your copy, and scores for how the face looks in that photo. It never names anyone. The photo is not stored or sent back.

  • POST /v1/face-reading/face-outline-image
  • Metered, from 15 credits
Get a free key API reference
Request
curl https://api.96astroapi.com/v1/face-reading/face-outline-image \  -H "Authorization: Bearer $ASTRO_API_KEY" \  -H "Content-Type: application/json" \  -d '{
      "image_base64": "iVBORw0KGgoAAAANSUhEUgAAAKAAAAB4CAAAAABQyaazAAAAgklEQVR42u3bQQoAIAgEQP//6fpCBsFWs2fBEbyJNcJTgICAgIDXACspgIeAp/aouvWAgICAgICAgICAgICAgICAgICAgICAgICAgICAgGsN0+/F4cCNgQABAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQE7QA/QbwMzAwgICPg7cAJxuHlDZty0owAAAABJRU5ErkJggg==",
      "mime_type": "image/png",
      "consent": true,
      "tier": "fast"
    }'

Overview

The outline of the face and its features traced on a photo, with an SVG overlay to lay over your copy, and scores for how the face looks in that photo. It never names anyone. The photo is not stored or sent back.

Call it with POST /v1/face-reading/face-outline-image. Input: a photo. Output: JSON, as a direct response. Each successful call costs metered, from 15 credits.

  • POST /v1/face-reading/face-outline-image
  • Metered, from 15 credits
  • A photo

Example response

Fields in dataThe response contract: required fields are always present.

  • outlinesarray of object
  • overlay_svgstring
  • coordinate_spaceobject
  • noticestring
  • tierstring
  • expressionobject
  • expression_notestring
200Example response (illustrative)

Written by hand from the documented shape: AI readings are not captured automatically. Real text, token counts and credits differ.

Loading the example…

Request schema and every field: the Face reading reference.

Related endpoints

FAQ

Face: Outline Traced API: common questions

4answers

Ask the team
01What does the Face: Outline Traced API return?

The outline of the face and its features traced on a photo, with an SVG overlay to lay over your copy, and scores for how the face looks in that photo. It never names anyone. The photo is not stored or sent back. The response's data object includes outlines, overlay_svg, coordinate_space, notice, tier, expression and expression_note. See the reference for an example response.

02What input does Face: Outline Traced need?

A photo.

03How much does a Face: Outline Traced call cost?

Metered, from 15 credits per successful call; a failed call is not charged. Plans and top-ups are on the pricing page.

04Can I try it before paying?

Yes. Every account gets sandbox keys and trial credits, so you can call it from your own code before choosing a plan.