C SDK

Official C client — build from GitHub Release v1.0.0.

On this page

Build and link
Quickstart
caedral_chat_completions_create(client, request)
Streaming (callback)
caedral_models_list(client)
caedral_usage_get(client)
caedral_embeddings_create(client, request)
caedral_images_generate(client, request)
caedral_audio_generate(client, request)
caedral_rerank_create(client, request)
Errors and memory

Official C client (static library libcaedral.a). Prefer TypeScript, Python, Go, or n8n for most integrations; use C for native / embedded workloads.

#Build and link

shell

1# Dependencies: C11 compiler, libcurl dev headers2git clone https://github.com/trycaedral/caedral-c.git3cd caedral-c4git checkout v1.0.05make6 7# Link your program:8gcc -o myapp myapp.c -I./include -L./build -lcaedral -lcurl

#Quickstart

main.cc

1#include "caedral.h"2#include <stdio.h>3#include <stdlib.h>4 5int main(void) {6    caedral_client_t *client = caedral_client_new("cd_live_...", "http://localhost:5001");7    if (client == NULL) {8        fprintf(stderr, "%s\n", caedral_get_last_error());9        return 1;10    }11 12    caedral_chat_request_t *req = caedral_chat_request_new("anthropic/claude-haiku-4.5");13    caedral_chat_request_add_message(req, "user", "Hello!");14 15    caedral_response_t *resp = caedral_chat_completions_create(client, req);16    if (resp == NULL) {17        fprintf(stderr, "%s\n", caedral_get_last_error());18        return 1;19    }20 21    char *content = caedral_chat_response_get_content(resp);22    printf("%s\n", content);23    caedral_free(content);24 25    caedral_response_free(resp);26    caedral_chat_request_free(req);27    caedral_client_free(client);28    return 0;29}

#caedral_chat_completions_create(client, request)

Create a non-streaming chat completion. Returns caedral_response_t* on success, NULL on failure (check caedral_get_last_error()).

#Streaming (callback)

1int on_chunk(const caedral_stream_chunk_t *chunk, void *user_data) {2    printf("%s\n", chunk->json);3    return 0; /* return non-zero to abort */4}5 6caedral_chat_completions_create_stream(client, req, on_chunk, NULL);

#caedral_models_list(client)

1caedral_response_t *resp = caedral_models_list(client);2const char *body = caedral_response_body(resp);3caedral_response_free(resp);

#caedral_usage_get(client)

1caedral_response_t *resp = caedral_usage_get(client);

#caedral_embeddings_create(client, request)

1caedral_embedding_request_t *req =2    caedral_embedding_request_new("caedral-embed", "Hello world");3caedral_response_t *resp = caedral_embeddings_create(client, req);4caedral_embedding_request_free(req);

#caedral_images_generate(client, request)

1caedral_image_request_t *req =2    caedral_image_request_new("A sunset over mountains");3caedral_response_t *resp = caedral_images_generate(client, req);4caedral_image_request_free(req);

#caedral_audio_generate(client, request)

1caedral_audio_request_t *req =2    caedral_audio_request_new("Welcome to Caedral.");3req->voice = "alloy";4caedral_response_t *resp = caedral_audio_generate(client, req);5caedral_audio_request_free(req);

#caedral_rerank_create(client, request)

1char *docs[] = {"API draws from subscription pools.", "Semantic cache hits bill at half price."};2caedral_rerank_request_t *req =3    caedral_rerank_request_new("How does billing work?", docs, 2);4req->top_n = 2;5caedral_response_t *resp = caedral_rerank_create(client, req);6caedral_rerank_request_free(req);

#Errors and memory

1if (resp == NULL) {2    fprintf(stderr, "status=%d type=%s msg=%s\n",3        caedral_get_last_status_code(),4        caedral_get_last_error_type(),5        caedral_get_last_error());6}7 8/* Free with matching *_free() or caedral_free() for helper strings */

1# Dependencies: C11 compiler, libcurl dev headers2git clone https://github.com/trycaedral/caedral-c.git3cd caedral-c4git checkout v1.0.05make6 7# Link your program:8gcc -o myapp myapp.c -I./include -L./build -lcaedral -lcurl

#Quickstart

main.cc

1#include "caedral.h"2#include <stdio.h>3#include <stdlib.h>4 5int main(void) {6    caedral_client_t *client = caedral_client_new("cd_live_...", "http://localhost:5001");7    if (client == NULL) {8        fprintf(stderr, "%s\n", caedral_get_last_error());9        return 1;10    }11 12    caedral_chat_request_t *req = caedral_chat_request_new("anthropic/claude-haiku-4.5");13    caedral_chat_request_add_message(req, "user", "Hello!");14 15    caedral_response_t *resp = caedral_chat_completions_create(client, req);16    if (resp == NULL) {17        fprintf(stderr, "%s\n", caedral_get_last_error());18        return 1;19    }20 21    char *content = caedral_chat_response_get_content(resp);22    printf("%s\n", content);23    caedral_free(content);24 25    caedral_response_free(resp);26    caedral_chat_request_free(req);27    caedral_client_free(client);28    return 0;29}

#caedral_chat_completions_create(client, request)

Create a non-streaming chat completion. Returns caedral_response_t* on success, NULL on failure (check caedral_get_last_error()).

#Streaming (callback)

1int on_chunk(const caedral_stream_chunk_t *chunk, void *user_data) {2    printf("%s\n", chunk->json);3    return 0; /* return non-zero to abort */4}5 6caedral_chat_completions_create_stream(client, req, on_chunk, NULL);

1caedral_embedding_request_t *req =2 caedral_embedding_request_new("caedral-embed", "Hello world");3caedral_response_t *resp = caedral_embeddings_create(client, req);4caedral_embedding_request_free(req);

1caedral_audio_request_t *req =2 caedral_audio_request_new("Welcome to Caedral.");3req->voice = "alloy";4caedral_response_t *resp = caedral_audio_generate(client, req);5caedral_audio_request_free(req);

#caedral_rerank_create(client, request)

1char *docs[] = {"API draws from subscription pools.", "Semantic cache hits bill at half price."};2caedral_rerank_request_t *req =3    caedral_rerank_request_new("How does billing work?", docs, 2);4req->top_n = 2;5caedral_response_t *resp = caedral_rerank_create(client, req);6caedral_rerank_request_free(req);

1if (resp == NULL) {2 fprintf(stderr, "status=%d type=%s msg=%s\n",3 caedral_get_last_status_code(),4 caedral_get_last_error_type(),5 caedral_get_last_error());6}7 8/* Free with matching *_free() or caedral_free() for helper strings */