V1ModelsRecommendations

Get model recommendations

Get model recommendations based on specified requirements

POST
/v1/models/recommendations
useCase?string

Use case for the model (e.g., chat, completion)

Value in"chat" | "completion" | "embedding" | "image" | "audio"
budget?number | null & string

Budget constraint for model pricing

performanceRequirements?object

Performance requirements

needsVision?boolean | null

Whether vision support is required

Defaultfalse
needsFunctions?boolean | null

Whether function calling support is required

Defaultfalse
needsStreaming?boolean | null

Whether streaming support is required

Defaultfalse
preferredProvider?string

Preferred provider (e.g., openai, anthropic)

minTokens?number

Minimum token capacity required

Range1 <= value

Response Body

curl -X POST "https://api-beta.daydreams.systems/v1/models/recommendations" \
  -H "Content-Type: application/json" \
  -d '{}'
{
  "requirements": {
    "useCase": "chat",
    "budget": 0,
    "performanceRequirements": {
      "latency": "string",
      "accuracy": "string"
    },
    "needsVision": false,
    "needsFunctions": false,
    "needsStreaming": false,
    "preferredProvider": "string",
    "minTokens": 1
  },
  "criteria": {
    "useCase": "chat",
    "budget": 0,
    "performanceRequirements": {
      "latency": "string",
      "accuracy": "string"
    },
    "needsVision": false,
    "needsFunctions": false,
    "needsStreaming": false,
    "preferredProvider": "string",
    "minTokens": 1
  },
  "recommendations": [
    {
      "model": {
        "name": "string",
        "provider": "string",
        "description": "string",
        "pricing": {
          "input": 0,
          "output": 0,
          "cache_read": 0,
          "cache_write": 0,
          "image": 0,
          "audio": 0
        },
        "capabilities": {
          "maxTokens": 0,
          "supportsStreaming": true,
          "supportsSystemMessages": true,
          "supportsFunctionCalling": true,
          "supportsVision": true,
          "supportsJson": true,
          "generatesImages": true,
          "generatesTextToVideo": true,
          "generatesImageToVideo": true,
          "tokenParameterType": "max_tokens"
        },
        "availability": {
          "status": "available",
          "lastChecked": 0
        }
      },
      "reasoning": {
        "valueScore": 0,
        "averagePrice": 0,
        "capabilityScore": 0,
        "matchesRequirements": {
          "vision": true,
          "functions": true,
          "streaming": true,
          "budget": true,
          "tokens": true
        }
      }
    }
  ],
  "totalAvailable": 0
}

{
  "error": "Invalid model specified",
  "code": "INVALID_MODEL",
  "message": "The specified model is not available"
}

{
  "error": "Internal server error",
  "code": "INTERNAL_SERVER_ERROR",
  "message": "An unexpected error occurred while processing your request"
}