Skip to main content

Documentation Index

Fetch the complete documentation index at: https://dev.writer.com/llms.txt

Use this file to discover all available pages before exploring further.

Deprecation notice: The following models are deprecated and will be removed on July 13, 2026: palmyra-x-003-instruct, palmyra-vision, palmyra-med, palmyra-fin, and palmyra-creative.Migration path: Use palmyra-x5 as the replacement for all deprecated models. Palmyra X5 supports a 1M-token context window and covers general-purpose, financial, medical, and creative use cases. For vision workloads, use chat with images with Palmyra X5 instead of palmyra-vision. See the deprecation policy for more information.
This guide helps you choose between Writer’s Palmyra models and external provider models when building agents in AI Studio. Both options are available through the Models page in AI Studio.

​
Palmyra models

Writer’s Palmyra models are pre-configured and immediately available in AI Studio. The Palmyra family includes:
ModelBest for
Palmyra X5General-purpose tasks with advanced reasoning
Palmyra X4Complex tasks requiring extended context
Palmyra MedHealthcare and medical applications
Palmyra FinFinancial services and analysis
Palmyra CreativeMarketing content and creative writing
Palmyra VisionImage and video understanding
For detailed capabilities, context windows, and use cases, see Palmyra models. For pricing, see Palmyra pricing.

​
External models

You can also add models from external providers like AWS Bedrock or Microsoft Azure (Azure OpenAI) to use alongside Palmyra models. External models require credential configuration but provide access to models like Claude, Llama, Mistral, and Azure-hosted OpenAI models.
ProviderStatusSetup guide
AWS BedrockAvailableConfigure AWS Bedrock
Microsoft AzureAvailableConfigure Microsoft Azure
NVIDIA NIMAvailableConfigure NVIDIA NIM
BasetenComing soon—
For information about adding and managing external models, see Add external models.

​
Compare Palmyra and external models

Consider the following factors when selecting models for your agents:
ConsiderationPalmyra modelsExternal models
SetupPre-configured, immediately availableRequires credential configuration
OptimizationOptimized for Writer platformVaries by provider
Specialized domainsPalmyra Med (healthcare), Palmyra Fin (finance)General-purpose models
ComplianceWriter-managed complianceYou manage provider compliance
BillingUnified billing through WriterBilled by provider (for example, AWS)
Cost visibilityIncluded in Writer dashboardTracked in Writer + provider billing

​
When to use Palmyra models

Palmyra models are the best choice when you need:
  • Domain-specific capabilities: Palmyra Med for healthcare, Palmyra Fin for finance, or Palmyra Creative for marketing content
  • Simplified billing: All usage appears on your Writer invoice
  • Writer platform features: Optimized integration with Knowledge Graphs and other Writer capabilities
  • Compliance simplicity: Writer manages model compliance and security

​
When to use external models

External models are the best choice when you need:
  • Existing provider agreements: You have AWS credits or enterprise agreements with cloud providers
  • Specific model access: You need a particular model not available through Writer (for example, Claude, Llama, or Mistral on Bedrock)
  • Provider-specific compliance: Your organization mandates specific cloud providers for AI workloads
  • Model comparison: You want to evaluate performance across different model providers
For information about adding and managing external models, see Add external models.

​
Use models in your applications

Once models are available in AI Studio, you can use them in Agent Builder, no-code apps, or via the API.

​
Agent Builder and no-code agents

In Agent Builder and no-code chat apps, select any available model from the Model dropdown. Both Palmyra models and any external models your team has access to appear in the list.

​
API usage

Use the List models endpoint to see all models available to your organization. You can then pass the model ID in any request that supports the model parameter. 
curl https://api.writer.com/v1/models \
  -H "Authorization: Bearer $WRITER_API_KEY"
To use a model, pass its ID to any completion endpoint. External models use the same API as Palmyra models—just swap the model ID: 
curl https://api.writer.com/v1/chat/completions \
  -H "Authorization: Bearer $WRITER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic.claude-3-sonnet-20240229-v1:0",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

​
Next steps