# API Overview

Aevos provides developers with comprehensive APIs to interact with and enhance the functionality of AI Agents within the Transcend ecosystem. These APIs ensure seamless integration and verification for all agent operations.

***

## **Inference API**

The Inference API allows developers to send input to AI Agents and receive verified output along with proof metadata.

#### **Example in cURL**

```bash
curl --request POST \
  --url https://api.aevos.ai/v1/verified/chat/completions \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "What is Aevos?"}
    ],
    "model": "gpt-4x"
  }'
```

#### **API Response**

```json
{
  "response": "Aevos is reshaping the future of blockchain-integrated AI Agents.",
  "proof_hash": "b29e674b9c330cf13f3643d46bc7e10510fa207a4e80645c795f82c3ddf9806ad",
  "signature": "e299c3b1294221d1200041993818cfbfec66f33d1071ea821e5068978099cd6"
}
```

***

## **Proof Validation API**

The Proof Validation API ensures the authenticity of cryptographic proofs generated by AI Agents, instilling confidence in the trustworthiness of the system.

#### **Example Response**

```json
{
  "hash": "fa1eb8b9c330cf13f3643d46bc7e10510fa207a4e80645c795f82c3ddf9806ad",
  "signature": "f298c3b1294221d1200041993818cfbfec66f33d1071ea821e5068978099cd6",
  "attestation": "aws-nitro-attestation-doc",
  "is_valid": true
}
```

***

## **Augmentation API**

The Augmentation API enables developers to enhance AI Agents by adding custom modules and functionalities.

#### **Code Example in Rust**

```rust
rustKopiërenBewerkenuse transcend_sdk::{Agent, Augmentation};

fn main() {
    let mut agent = Agent::new("your-api-key");
    let module = Augmentation::new("Advanced Reasoning", vec!["deductive logic", "contextual understanding"]);

    match agent.add_augmentation(module) {
        Ok(_) => println!("Augmentation added successfully!"),
        Err(e) => println!("Error adding augmentation: {:?}", e),
    }
}
```

***

## **Key Features of the Transcend API**

* **Real-Time Interactions**: Enables dynamic, real-time conversations and workflows with AI Agents.
* **Cryptographic Verification**: Every action is backed by secure proofs, ensuring trust and transparency.
* **Customizability**: Developers can tailor AI Agent functionalities through modular augmentations.
* **Ease of Use**: With comprehensive documentation and developer-friendly endpoints, integration is streamlined.

***

## **API Resources**

* **Developer Portal**: Access API keys, manage projects, and view detailed analytics.
* **Transcend Explorer**: Monitor agent interactions and verify proofs in real-time.
* **SDK Support**: APIs are compatible with multiple languages, including Rust, Python, and JavaScript.

With these APIs, Aevos empowers developers to create, deploy, and manage intelligent, secure, and verifiable AI Agents seamlessly within the blockchain ecosystem.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://aevos.gitbook.io/aevos/for-developers/api-overview.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
