Get Started
Examples
Concepts
Resources
Projects
Integrations
Structured Outputs
copy markdown
Structured output allows you to get high quality responses in a fixed defined, consistent and predictable format in JSON output format.
- Reliable consistency and type safety
- Works with schema validation libraries like Zod, Pydantic, etc.
- Deterministic control over the response for your applications
- Follows the OpenAI structured output specification
Note: There is a known issue with
zodResponseFormatin the latest OpenAI SDK release. Please refer to this GitHub issue for details, or use Zod version 3.23.8 as a workaround.
Basic structured output
OpenAI SDK
Vercel AI SDK
LangChain SDK
typescript
python
import { z } from "zod";
import { zodResponseFormat } from "openai/helpers/zod";
const founderSchema = z.object({
name: z.string().describe("The full name of the founder"),
});
const response = await interfaze.chat.completions.create({
model: "interfaze-beta",
messages: [
{
role: "user",
content: "Who is the founder of Interfaze?",
},
],
response_format: zodResponseFormat(founderSchema, "founder_schema"),
});
console.log(response.choices[0].message.content);Schema defined JSON Output
{
"object": {
"name": "Yoeven D Khemlani"
}
}Full JSON Response
The raw precontext field is also available along with requested schema depending on the task that was run like web search, OCR, etc.
Learn more about precontext.
{
"object": {
"name": "Yoeven D Khemlani"
},
"response": {
"id": "interfaze-1775270750639",
"modelId": "interfaze-beta",
"body": {
"id": "interfaze-1775270750639",
"object": "chat.completion",
"model": "interfaze-beta",
"usage": {
"prompt_tokens": 10512,
"completion_tokens": 7056,
"total_tokens": 17568
},
"vcache": false,
"precontext": [
{
"name": "search",
"result": [
{
"title": "Interfaze: AI model built for deterministic developer tasks | Y Combinator",
"description": "Open menu\n\nAbout\n\nWhat Happens at YC? Apply YC Interview Guide FAQ People YC Blog\n\nCompanies\n\nStartup Directory Founder Directory Launch YC\n\nLibrary\n\nPartners\n\nResources\n\n[Startup School](https://startupschool.org?utm_source=yc&utm_campaign=ycdc_header) Newsletter Requests for Startups For Investors Verify Founders [Hacker News](https://news.ycombinator.com/) [Bookface](https://bookface.ycombinator.com) Safe Find a Co-Founder\n\nStartup Jobs\n\n Apply\n\nHome › Companies › Interfaze\n\nInterfaze\n\nAI model built for deterministic developer tasks\n\nSpring 2026\n\nActive\n\nDeep Learning Developer Tools Generative AI San Francisco\n\n* * *\n\nCompany\n\nJobs 0\n\n[https://interfaze.ai](https://interfaze.ai)\n\n* * *\n\n### AI model built for deterministic developer tasks\n\nInterfaze is an AI model built on a new architecture that merges specialized DNN/CNN models with LLMs for developer tasks that require deterministic output and high consistency like OCR, web scraping, classification, Speech-to-text (STT) and more.\nRead paper:https://arxiv.org/abs/2602.04101\n\nActive Founders\n\nYoeven D Khemlani\n\n[](https://x.com/yoeven) [](https://linkedin.com/in/yoeven)\n\nFounder\n\nBuilding https://interfaze.ai\n\nYoeven D Khemlani\n\n[](https://x.com/yoeven) [](https://linkedin.com/in/yoeven)\n\nFounder\n\nBuilding https://interfaze.ai\n\nHarsha Vardhan Khurdula\n\n[](https://x.com/khurdula) [](https://www.linkedin.com/in/harsha-vardhan-khurdula-99b400183/)\n\nCo-Founder & CTO\n\nBuilding https://interfaze.ai\n\nHarsha Vardhan Khurdula\n\n[](https://x.com/khurdula) [](https://www.linkedin.com/in/harsha-vardhan-khurdula-99b400183/)\n\nCo-Founder & CTO\n\nBuilding https://interfaze.ai\n\nInterfaze\n\nFounded: 2025\n\nBatch: Spring 2026\n\nTeam Size: 5\n\nStatus: Active\n\nLocation: San Francisco\n\nPrimary Partner: [Aaron Epstein](https://www.ycombinator.com/people/aaron-epstein)\n\n[](https://interfaze.ai) [](https://www.linkedin.com/company/interfaze-ai) [](https://x.com/interfaze_ai) [](https://www.crunchbase.com/organization/jigsawstack) [](https://github.com/JigsawStack)\n\n## Footer\n\nY Combinator\n\n### Make something people want.\n\n### Programs\n\n* YC Program\n* [Startup School](https://startupschool.org)\n* Work at a Startup\n* Co-Founder Matching\n\n### Resources\n\n* Startup Directory\n* Startup Library\n* Investors\n* Demo Day\n* Safe\n* [Hacker News](https://news.ycombinator.com/)\n* Launch YC\n* [YC Deals](https://deals.ycombinator.com)\n\n### Company\n\n* YC Blog\n* Contact\n* Press\n* People\n* Careers\n* Privacy Policy\n* Notice at Collection\n* Security\n* Terms of Use\n\n[Twitter](https://twitter.com/ycombinator) [Facebook](https://www.facebook.com/YCombinator/) [Instagram](https://www.instagram.com/ycombinator) [LinkedIn](https://www.linkedin.com/school/y-combinator/) [Youtube](https://www.youtube.com/c/ycombinator)",
"content": "AI model built for deterministic developer tasks. Founded in 2025 by Yoeven D Khemlani and Harsha Vardhan Khurdula, Interfaze has 5 employees based in San Francisco, CA, USA.\nFooter\nAI model built for deterministic developer tasks Make something people want. Programs Resources Company\n© 2026 Y Combinator\nYC Program Startup School Work at a Startup Co-Founder Matching Startup Directory Startup Library Investors Demo Day Safe Hacker News Launch YC YC Deals YC Blog Contact Press People Careers Privacy Policy Notice at Collection Security Terms of Use\nAbout What Happens at YC? Apply YC Interview Guide FAQ People YC Blog Companies Startup Directory Founder Directory Launch YC Library Partners Resources Startup School Newsletter Requests for Startups For Investors Verify Founders Hacker News Bookface Safe Find a Co-Founder Startup Jobs Log in Apply Home Companies Spring 2026 Deep Learning Developer Tools Generative AI San Francisco Company Jobs https://interfaze.ai Interfaze Aaron Epstein Y Combinator YC Program Startup School Work at a Startup Co-Founder Matching Startup Directory Startup Library Investors Demo Day Safe Hacker News Launch YC YC Deals YC Blog Contact Press People Careers Privacy Policy Notice at Collection Security Terms of Use Twitter Facebook Instagram LinkedIn Youtube\nOpen menu › › Interfaze Spring 2026 0 Founded: 2025 Batch: Spring 2026 Team Size: 5 Status: Active Location: San Francisco Primary Partner: Y Combinator Twitter Facebook Instagram LinkedIn Youtube",
"snippets": [],
"url": "https://www.ycombinator.com/companies/interfaze"
},
{
"title": "Yoeven D Khemlani's Post - LinkedIn",
"description": "Mar 16, 2026 · The moment he realised that interfaze ... Yoeven D Khemlani's Post. View profile for Yoeven D Khemlani · Yoeven D Khemlani. Founder at Interfaze.",
"content": "The moment he realised that interfaze.ai isn't fully built on transformers and we can run on a single GPU with high accuracy and lower cost\nYoeven D Khemlani’s Post\nExplore content categories\nThe moment he realised that interfaze.ai isn't fully built on transformers and we can run on a single GPU with high accuracy and lower cost Yoeven D Khemlani Exciting to see innovative approaches in AI making waves! 🌊 To view or add a comment, sign in 4,034 followers\nReport this post Copy LinkedIn Facebook X Report this comment 174 Posts Career Productivity Finance Soft Skills & Emotional Intelligence Project Management Education Technology Leadership Ecommerce User Experience\nYoeven D Khemlani Report this post interfaze.ai 54 1 Comment Like Comment Lewis Tinker Report this comment Yoeven D Khemlani Like Reply sign in 174 Posts View Profile Connect Career Productivity Finance Soft Skills & Emotional Intelligence Project Management Education Technology Leadership Ecommerce User Experience\n2w 54 Like Comment Share Copy LinkedIn Facebook X 2w Like Reply 1 Reaction Connect",
"snippets": [],
"url": "https://www.linkedin.com/posts/yoeven_the-moment-he-realised-that-interfazeai-activity-7439477585035669504-zpkQ"
},
{
"title": "Michael Cope — Health Wildcatters",
"description": "0\n\n## Michael Cope\n\nMichael Cope is founder and retired CEO and Chairman of Interphase Corporation, a Dallas computer hardware manufacturer. After founding Interphase in 1974, Michael established it as the preeminent player in its market niche, lead it through a successful IPO in 1984 and a secondary public offering in 1991, as well as a strategic investment by Motorola. During his 20 year tenure, Interphase grew from a self-funded Dallas startup to a public technology company with over 350 employees and an international presence, was named to the INC 500, the INC 200, the FORBES 200 Best Run Small Companies in America and Mike was twice honored as an Entrepreneur-of-the-Year finalist.\n\nSince 1994, he helped launch numerous start-ups, including multiple times as a founder. As an Angel investor he has enjoyed multiple successful exits, including acquisitions by major companies as well as Private Equity groups. Combining his technical background with market positioning, corporate infrastructure and financing experience, he often serves as a coach/advisor to CEOs, or a technical advisor to investors. He is associated with a variety of Angel groups and accelerators based in Texas and elsewhere, including _Health Wildcatters_ , _Tech Wildcatters, Southwest Angel Impact Investing Network (SWAN), The Capital Factory and Dallas Social Venture Partner and others._\n\nMichael attended Vanderbilt University (BSEE) , is a Registered Professional Engineer and holds 46 US and international patents in the area of networking technology. Prior to founding Interphase, he Co-founded Avicon Development Group. As an early and influential player in the computer industry, he is considered a friend and colleague by many computer industry luminaries.\n\nHe and his wife live part of the year in Southlake, Texas and part of the year in Bonaire (a Dutch Caribbean island) where they pursue their mutual passion of Scuba Diving and international travel. Michael is also an avid sailor and enjoys music, cooking, racquetball and trail running.\n\n#### **Quick Links**\n\n```\nEvents News Accelerator\n```\n\n[](https://collisionsdfw.net/)\n\n#### **Latest Tweets**\n\n[Tweets by HWildCatters](https://twitter.com/HWildCatters?ref_src=twsrc%5Etfw)\n\n#### Health Wildcatters\n\n3000 Pegasus Park Drive Suite 1330 \nDallas, TX 75247\n\n[](https://www.linkedin.com/company/health-wildcatters/) [](http://x.com/HWildCatters) [](https://www.facebook.com/HealthWildcatters) [](http://instagram.com/healthwildcatters)",
"content": "Michael Cope\nMichael Cope is founder and retired CEO and Chairman of Interphase Corporation, a Dallas computer hardware manufacturer. After founding Interphase in 1974, Michael established it as the preeminent player in its market niche, lead it through a successful IPO in 1984 and a secondary public offering in 1991, as well as a strategic investment by Motorola. During his 20 year tenure, Interphase grew from a self-funded Dallas startup to a public technology company with over 350 employees and an international presence, was named to the INC 500, the INC 200, the FORBES 200 Best Run Small Companies in America and Mike was twice honored as an Entrepreneur-of-the-Year finalist. Since 1994, he helped launch numerous start-ups, including multiple times as a founder. As an Angel investor he has enjoyed multiple successful exits, including acquisitions by major companies as well as Private Equity groups. Combining his technical background with market positioning, corporate infrastructure and financing experience, he often serves as a coach/advisor to CEOs, or a technical advisor to investors. He is associated with a variety of Angel groups and accelerators based in Texas and elsewhere, including Health Wildcatters, Tech Wildcatters, Southwest Angel Impact Investing Network (SWAN), The Capital Factory and Dallas Social Venture Partner and others. Michael attended Vanderbilt University (BSEE) , is a Registered Professional Engineer and holds 46 US and international patents in the area of networking technology. Prior to founding Interphase, he Co-founded Avicon Development Group. As an early and influential player in the computer industry, he is considered a friend and colleague by many computer industry luminaries. He and his wife live part of the year in Southlake, Texas and part of the year in Bonaire (a Dutch Caribbean island) where they pursue their mutual passion of Scuba Diving and international travel. Michael is also an avid sailor and enjoys music, cooking, racquetball and trail running.",
"snippets": [],
"url": "https://www.healthwildcatters.com/michael-cope"
},
{
"title": "Interfaze - F6S",
"description": "Overview. San Francisco, California, United States. Founded 2024. Raised from ... Interfaze founders & employees. Yoeven D Khemlani | F6S - Images. Yoeven D",
"content": "Overview. San Francisco, California, United States. Founded 2024. Raised from ... Interfaze founders & employees. Yoeven D Khemlani | F6S - Images. Yoeven D",
"url": "https://www.f6s.com/company/interfaze"
}
]
}
]
}
},
"request": {
"body": {
"model": "interfaze-beta",
"response_format": {
"type": "json_schema",
"json_schema": {
"schema": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "The full name of the founder"
}
},
"required": ["name"],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
},
"strict": false,
"name": "response"
}
},
"messages": [
{
"role": "user",
"content": "Who is the founder of Interfaze?"
}
]
}
},
"finishReason": "stop",
"usage": {
"inputTokens": 10512,
"outputTokens": 7056,
"totalTokens": 17568
}
}Complex structured output
OpenAI SDK
Vercel AI SDK
LangChain SDK
typescript
python
import { z } from "zod";
import { zodResponseFormat } from "openai/helpers/zod";
const DetectionSchema = z.object({
objects: z.array(
z.object({
name: z.string().describe("describe the object in the image"),
top_left_x: z.number(),
top_left_y: z.number(),
bottom_right_x: z.number(),
bottom_right_y: z.number(),
})
),
texts: z
.array(
z.object({
text: z.string(),
top_left_x: z.number(),
top_left_y: z.number(),
bottom_right_x: z.number(),
bottom_right_y: z.number(),
})
)
.describe("any alphabetic characters text in the image"),
});
const response = await interfaze.chat.completions.create({
model: "interfaze-beta",
messages: [
{
role: "user",
content: [
{ type: "text", text: "Get the position of the crane in the image and any text" },
{
type: "image_url",
image_url: {
url: "https://r2public.jigsawstack.com/interfaze/examples/construction.png",
},
},
],
},
],
response_format: zodResponseFormat(DetectionSchema, "detection_schema"),
});
console.log(response.choices[0].message.content);
//@ts-expect-error precontext is not typed
const precontext = response.precontext;
console.log("Object Detection Results:", precontext[0]?.result);JSON output
object contains the extracted information defined in the schema. precontext contains the raw metadata such as bounding boxes and confidence scores.
{
"object": {
"objects": [
{
"name": "crane",
"top_left_x": 630,
"top_left_y": 139,
"bottom_right_x": 769,
"bottom_right_y": 225
}
],
"texts": [
{
"text": "09-12-2020 Sat 21:26:51",
"top_left_x": 218,
"top_left_y": 88,
"bottom_right_x": 623,
"bottom_right_y": 117
},
{
"text": "WRW tower",
"top_left_x": 1069,
"top_left_y": 720,
"bottom_right_x": 1230,
"bottom_right_y": 751
}
]
},
"response": {
"id": "interfaze-1775001605439",
"modelId": "interfaze-beta",
"body": {
"id": "interfaze-1775001605439",
"object": "chat.completion",
"model": "interfaze-beta",
"usage": {
"prompt_tokens": 4903,
"completion_tokens": 8566,
"total_tokens": 13469
},
"precontext": [
{
"name": "object_detection",
"result": {
"detected_objects": [
{
"bounds": {
"top_left": {
"x": 630,
"y": 139
},
"top_right": {
"x": 769,
"y": 139
},
"bottom_left": {
"x": 630,
"y": 225
},
"bottom_right": {
"x": 769,
"y": 225
},
"width": 139,
"height": 86
},
"label": "crane"
}
],
"gui_elements": [
{
"type": "text",
"bounds": {
"top_left": {
"x": 1140,
"y": 722
},
"top_right": {
"x": 1232,
"y": 722
},
"bottom_left": {
"x": 1140,
"y": 752
},
"bottom_right": {
"x": 1232,
"y": 752
},
"width": 92,
"height": 30
},
"interactivity": false,
"content": "tower"
}
]
}
},
{
"name": "ocr",
"result": {
"extracted_text": "09-12-2020 Sat 21:26:51\nWRW tower",
"sections": [
{
"text": "09-12-2020 Sat 21:26:51\nWRW tower",
"lines": [
{
"text": "09-12-2020 Sat 21:26:51",
"bounds": {
"top_left": {
"x": 218,
"y": 88
},
"top_right": {
"x": 623,
"y": 87
},
"bottom_right": {
"x": 623,
"y": 117
},
"bottom_left": {
"x": 218,
"y": 118
},
"width": 405,
"height": 30
},
"average_confidence": 0.99,
"words": [
{
"text": "09-12-2020",
"bounds": {
"top_left": {
"x": 219,
"y": 90
},
"top_right": {
"x": 392,
"y": 88
},
"bottom_right": {
"x": 391,
"y": 117
},
"bottom_left": {
"x": 219,
"y": 117
},
"width": 172.5,
"height": 28
},
"confidence": 0.99
},
{
"text": "Sat",
"bounds": {
"top_left": {
"x": 413,
"y": 88
},
"top_right": {
"x": 464,
"y": 88
},
"bottom_right": {
"x": 463,
"y": 117
},
"bottom_left": {
"x": 413,
"y": 117
},
"width": 50.5,
"height": 29
},
"confidence": 1
},
{
"text": "21:26:51",
"bounds": {
"top_left": {
"x": 483,
"y": 88
},
"top_right": {
"x": 622,
"y": 87
},
"bottom_right": {
"x": 622,
"y": 118
},
"bottom_left": {
"x": 483,
"y": 117
},
"width": 139,
"height": 30
},
"confidence": 0.99
}
]
},
{
"text": "WRW tower",
"bounds": {
"top_left": {
"x": 1069,
"y": 720
},
"top_right": {
"x": 1230,
"y": 721
},
"bottom_right": {
"x": 1230,
"y": 751
},
"bottom_left": {
"x": 1069,
"y": 750
},
"width": 161,
"height": 30
},
"average_confidence": 0.99,
"words": [
{
"text": "WRW",
"bounds": {
"top_left": {
"x": 1070,
"y": 721
},
"top_right": {
"x": 1120,
"y": 721
},
"bottom_right": {
"x": 1120,
"y": 750
},
"bottom_left": {
"x": 1070,
"y": 751
},
"width": 50,
"height": 29.5
},
"confidence": 0.99
},
{
"text": "tower",
"bounds": {
"top_left": {
"x": 1145,
"y": 722
},
"top_right": {
"x": 1227,
"y": 723
},
"bottom_right": {
"x": 1227,
"y": 750
},
"bottom_left": {
"x": 1145,
"y": 750
},
"width": 82,
"height": 27.5
},
"confidence": 0.99
}
]
}
]
}
],
"width": 1400,
"height": 789
}
}
]
}
},
"finishReason": "stop",
"usage": {
"inputTokens": 4903,
"outputTokens": 8566,
"totalTokens": 13469
}
}