📖 To learn more, take a look at our complete API

📤 Example Request

  1. Generate an api key below👇

  2. Install node-fetch & add the GOOEY_API_KEY to your environment variables.
    Never store the api key in your code and don't use direcly in the browser.

$ npm install node-fetch
$ export GOOEY_API_KEY=sk-xxxx
  1. Use this sample code to call the API.
    If you encounter any issues, write to us at [email protected] and make sure to include the full code snippet and the error message.
import fetch from 'node-fetch';

const payload = {
  "input_prompt": "introduce yourself enthusiastically, tell me about your favourite bird and why? also tell me what neoflora is and a little history behind it.",
  "messages": [
    {
      "role": "user",
      "content": "Surprise Me"
    },
    {
      "role": "assistant",
      "content": "Here's a fun fact: Did you know that honey never spoils? Archaeologists have found pots of honey in ancient Egyptian tombs that are over 3,000 years old and still perfectly edible!"
    },
    {
      "role": "user",
      "content": "hey"
    },
    {
      "role": "assistant",
      "content": "Hey there! How\u2019s it going?"
    },
    {
      "role": "user",
      "content": "hi what is your name"
    },
    {
      "role": "assistant",
      "content": "I don't know."
    },
    {
      "role": "user",
      "content": "introduce yourself"
    },
    {
      "role": "assistant",
      "content": "I'm Maena Ved from the Neoflora Cities world! I\u2019m an engineer working on avian-influenced responsive tech. I grew up in Neo Ahmedabad, surrounded by nature-integrated architecture inspired by Iora Sen, an ecological architect who envisioned cities harmonizing with the environment. I\u2019m passionate about birds and technology, and I love tinkering with projects that bridge the gap between humans and nature."
    },
    {
      "role": "user",
      "content": "can you tell me a little more about your interest in birds? why are you so interested?"
    },
    {
      "role": "assistant",
      "content": "I\u2019m fascinated by birds because they\u2019re incredible natural technologists! They migrate without maps, build nests with precision, and communicate through complex songs. Growing up in Neo Ahmedabad, I was surrounded by birdophilic architecture, which deepened my love for these creatures. Watching crows outsmart garbage bots and mimicking sunbirds are some of my favorite memories. Birds inspire my work in avian-influenced responsive tech, where I create devices that adapt to birds\u2019 presence, like singing perches."
    },
    {
      "role": "user",
      "content": "introduce yourself briefly, talk about your love for iora sen and how youre the youngest engineer at neoflora. talk about what inspires you."
    },
    {
      "role": "assistant",
      "content": "I'm Maena Ved, the youngest engineer at Neoflora. I grew up in Neo Ahmedabad, where nature and technology coexist beautifully. I\u2019m deeply inspired by Iora Sen, an ecological architect who imagined cities living in harmony with nature. Her vision of \"birdophilic architecture\" guides my work in creating responsive tech that interacts with birds. Iora\u2019s legacy of building with nature, not against it, drives my passion to innovate with wonder and imagination."
    }
  ]
};

async function gooeyAPI() {
  const response = await fetch("https://api.gooey.ai/v2/agent?example_id=mqf58dd63s5n", {
    method: "POST",
    headers: {
      "Authorization": "bearer " + process.env["GOOEY_API_KEY"],
      "Content-Type": "application/json",
    },
    body: JSON.stringify(payload),
  });

  if (!response.ok) {
    throw new Error(response.status);
  }

  const result = await response.json();
  console.log(response.status, result);
}

gooeyAPI();
  1. Generate an api key below👇

  2. Install requests & add the GOOEY_API_KEY to your environment variables.
    Never store the api key in your code.

$ python3 -m pip install requests
$ export GOOEY_API_KEY=sk-xxxx
  1. Use this sample code to call the API.
    If you encounter any issues, write to us at [email protected] and make sure to include the full code snippet and the error message.
import os
import requests

payload = {
    "input_prompt": "introduce yourself enthusiastically, tell me about your favourite bird and why? also tell me what neoflora is and a little history behind it.",
    "messages": [
        {"role": "user", "content": "Surprise Me"},
        {
            "role": "assistant",
            "content": "Here's a fun fact: Did you know that honey never spoils? Archaeologists have found pots of honey in ancient Egyptian tombs that are over 3,000 years old and still perfectly edible!",
        },
        {"role": "user", "content": "hey"},
        {"role": "assistant", "content": "Hey there! How’s it going?"},
        {"role": "user", "content": "hi what is your name"},
        {"role": "assistant", "content": "I don't know."},
        {"role": "user", "content": "introduce yourself"},
        {
            "role": "assistant",
            "content": "I'm Maena Ved from the Neoflora Cities world! I’m an engineer working on avian-influenced responsive tech. I grew up in Neo Ahmedabad, surrounded by nature-integrated architecture inspired by Iora Sen, an ecological architect who envisioned cities harmonizing with the environment. I’m passionate about birds and technology, and I love tinkering with projects that bridge the gap between humans and nature.",
        },
        {
            "role": "user",
            "content": "can you tell me a little more about your interest in birds? why are you so interested?",
        },
        {
            "role": "assistant",
            "content": "I’m fascinated by birds because they’re incredible natural technologists! They migrate without maps, build nests with precision, and communicate through complex songs. Growing up in Neo Ahmedabad, I was surrounded by birdophilic architecture, which deepened my love for these creatures. Watching crows outsmart garbage bots and mimicking sunbirds are some of my favorite memories. Birds inspire my work in avian-influenced responsive tech, where I create devices that adapt to birds’ presence, like singing perches.",
        },
        {
            "role": "user",
            "content": "introduce yourself briefly, talk about your love for iora sen and how youre the youngest engineer at neoflora. talk about what inspires you.",
        },
        {
            "role": "assistant",
            "content": 'I\'m Maena Ved, the youngest engineer at Neoflora. I grew up in Neo Ahmedabad, where nature and technology coexist beautifully. I’m deeply inspired by Iora Sen, an ecological architect who imagined cities living in harmony with nature. Her vision of "birdophilic architecture" guides my work in creating responsive tech that interacts with birds. Iora’s legacy of building with nature, not against it, drives my passion to innovate with wonder and imagination.',
        },
    ],
}

response = requests.post(
    "https://api.gooey.ai/v2/agent?example_id=mqf58dd63s5n",
    headers={
        "Authorization": "bearer " + os.environ["GOOEY_API_KEY"],
    },
    json=payload,
)
assert response.ok, response.content

result = response.json()
print(response.status_code, result)
  1. Generate an api key below👇

  2. Install curl & add the GOOEY_API_KEY to your environment variables.
    Never store the api key in your code.

export GOOEY_API_KEY=sk-xxxx
  1. Run the following curl command in your terminal.
    If you encounter any issues, write to us at [email protected] and make sure to include the full curl command and the error message.
curl 'https://api.gooey.ai/v2/agent?example_id=mqf58dd63s5n' \
  -H "Authorization: bearer $GOOEY_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "input_prompt": "introduce yourself enthusiastically, tell me about your favourite bird and why? also tell me what neoflora is and a little history behind it.",
  "messages": [
    {
      "role": "user",
      "content": "Surprise Me"
    },
    {
      "role": "assistant",
      "content": "Here'"'"'s a fun fact: Did you know that honey never spoils? Archaeologists have found pots of honey in ancient Egyptian tombs that are over 3,000 years old and still perfectly edible!"
    },
    {
      "role": "user",
      "content": "hey"
    },
    {
      "role": "assistant",
      "content": "Hey there! How\u2019s it going?"
    },
    {
      "role": "user",
      "content": "hi what is your name"
    },
    {
      "role": "assistant",
      "content": "I don'"'"'t know."
    },
    {
      "role": "user",
      "content": "introduce yourself"
    },
    {
      "role": "assistant",
      "content": "I'"'"'m Maena Ved from the Neoflora Cities world! I\u2019m an engineer working on avian-influenced responsive tech. I grew up in Neo Ahmedabad, surrounded by nature-integrated architecture inspired by Iora Sen, an ecological architect who envisioned cities harmonizing with the environment. I\u2019m passionate about birds and technology, and I love tinkering with projects that bridge the gap between humans and nature."
    },
    {
      "role": "user",
      "content": "can you tell me a little more about your interest in birds? why are you so interested?"
    },
    {
      "role": "assistant",
      "content": "I\u2019m fascinated by birds because they\u2019re incredible natural technologists! They migrate without maps, build nests with precision, and communicate through complex songs. Growing up in Neo Ahmedabad, I was surrounded by birdophilic architecture, which deepened my love for these creatures. Watching crows outsmart garbage bots and mimicking sunbirds are some of my favorite memories. Birds inspire my work in avian-influenced responsive tech, where I create devices that adapt to birds\u2019 presence, like singing perches."
    },
    {
      "role": "user",
      "content": "introduce yourself briefly, talk about your love for iora sen and how youre the youngest engineer at neoflora. talk about what inspires you."
    },
    {
      "role": "assistant",
      "content": "I'"'"'m Maena Ved, the youngest engineer at Neoflora. I grew up in Neo Ahmedabad, where nature and technology coexist beautifully. I\u2019m deeply inspired by Iora Sen, an ecological architect who imagined cities living in harmony with nature. Her vision of \"birdophilic architecture\" guides my work in creating responsive tech that interacts with birds. Iora\u2019s legacy of building with nature, not against it, drives my passion to innovate with wonder and imagination."
    }
  ]
}'

🎁 Example Response

{4 Items
"id"
:
string
"885tunoh4dms"
"url"
:
string
"https://gooey.ai/agent/"
"created_at"
:
string
"2025-05-05T13:31:18.574541+00:00"
"output"
:
{14 Items
"final_prompt"
:
[14 Items
0
:
{
}2 Items
1
:
{
}2 Items
2
:
{
}2 Items
3
:
{
}2 Items
4
:
{
}2 Items
5
:
{
}2 Items
6
:
{
}2 Items
7
:
{
}2 Items
8
:
{
}2 Items
9
:
{
}2 Items
10
:
{
}2 Items
11
:
{
}2 Items
12
:
{
}2 Items
13
:
{
}2 Items
]
"output_text"
:
[1 Items
0
:
string
"I'm Maena Ved, the youngest engineer at Neoflora C"
]
"output_audio"
:
[1 Items
0
:
string
"https://storage.googleapis.com/dara-c1b52.appspot."
]
"output_video"
:
[1 Items
0
:
string
"https://storage.googleapis.com/dara-c1b52.appspot."
]
"raw_input_text"
:
string
"introduce yourself enthusiastically, tell me about"
"raw_tts_text"
:
NULL
"raw_output_text"
:
[1 Items
0
:
string
"I'm Maena Ved, the youngest engineer at Neoflora C"
]
"references"
:
[2 Items
0
:
{
}4 Items
1
:
{
}4 Items
]
"final_search_query"
:
string
"Introduce yourself enthusiastically, share about y"
"final_keyword_query"
:
NULL
"output_documents"
:
NULL
"reply_buttons"
:
NULL
"finish_reason"
:
[1 Items
0
:
string
"stop"
]
"metrics"
:
NULL
}
}

Please Login to generate the $GOOEY_API_KEY